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JOURNAL 


Microsoft Windows als Basis einer einzigartigen Entwicklungsum- 
gebung: SQLWindows bietet Programmierern die Möglichkeit, 
Dateneingabe- und -manipulationswerkzeuge zu erstellen, die die 
ausgefeilte Benutzerschnittstelle von Microsoft Windows mit der 
Leistungsfähigkeit und Universalität von SQL kombinieren. 


Eine Systemutility für Windows: In diesem Artikel wird eine An- 
wendung für Windows entwickelt, die nach einer einstellbaren 
Zeit des »Nichtstuns« am Rechner (keine Tastatur- oder Maus- 
eingabe) den Bildschirm dunkel schaltet, bis wieder eine Ein- 
gabeaktion stattfindet. 


Dialoge ganz nebenbei: In Microsoft Windows 2.0 ist es möglich, 
Dialogboxen oder Eingabemasken dynamisch, so ganz »nebenbei« 
zu erzeugen. Wir zeigen, wie’s geht. 





Eine einfache Utility erleichtert die Windows-Programmierung: 
Unglücklicherweise funktionieren viele der traditionellen Test- 
Techniken in der Windows-Umgebung nicht, doch es gibt äquiva- 
lente Möglichkeiten. 


Bald gibt es den interaktiven Debugger CodeView auch für 
Microsoft Windows. Wir haben uns eine Beta-Version ausführlich 
angesehen. 


Microsoft hat soeben die Version 4.0 von MS-DOS angekündigt. 
Wir beschreiben die Neuheiten, deren wichtigste die bildschirm- 
orientierte Benutzerschnittstelle ist. 


Still going strong: Nach acht Jahren und zahlreichen Versionen ist 
MS-DOS in der Version 4.0 so komfortabel und umfangreich wie 
nie zuvor. Anlaß für uns, uns einmal ausführlich mit der Entwick- 
lungsgeschichte von MS-DOS von 1980 bis heute zu beschäftigen. 


Die Version 5.1 des Microsoft Makro-Assemblers bietet viele neue 
Möglichkeiten, die die Programmierung in Assembler bedeutend 
vereinfachen. 


Neue Produkte, Aktuelles. 

Die Termine des Microsoft-Instituts. 

Tips zu Microsoft Windows. 

Die PC-Referenz für Programmierer. 

Nützliche Tabellen für die Programmierung. 

Große Übersicht: Die Zeichensätze von MS-DOS und Windows. 
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Die Datenbankoberfläche SOLWindows 


Die Firma Gupta Technologies aus Menlo Park, 
Kalifornien, ein Anbieter von Datenbanksoft- 
ware, hat vor kurzem eine einzigartige Windows- 
Anwendung mit dem Namen SQLWindows vor- 
gestellt. Dabei handelt es sich um ein Anwen- 
dungsentwicklungssystem, das auf Datenbanken 
spezialisiert ist, die mit der Abfragesprache SQL 
(structured query language) arbeiten. Es wurde 
entwickelt, um Programmierern die Möglichkeit 
zu bieten, Dateneingabe- und -manipulations- 
werkzeuge zu erstellen, die die ausgefeilte 
Benutzerschnittstelle von Microsoft Windows 
mit der Leistungsfähigkeit und Universalität von 
SQL kombinieren. 


SQLWindows ist das dritte Glied in einer Reihe von 
Datenverwaltungsprodukten, die Gupta Technologies das 
SOL-System nennt. Die beiden anderen Komponenten sind 
SQLBase, ein Datenbankserver für 80286/386-Umgebun- 
gen und SOLNet, eine transparente Brücke zu IBMs DB2. 
(Zukünftige Versionen werden auch Verbindungen zu 
anderen Großrechnern-DBMS bieten.) 

Gupta Technologies wurde 1984 von Umang P. Gupta 
und D. Bruce Scott gegründet, die vorher in Schlüsselstel- 
lungen bei Oracle beschäftigt waren. Gupta war der Vize- 
präsident und Leiter der Mikrocomputerprodukte-Abtei- 
lung bei Oracle und Scott ist ein Co-Autor des Oracle 
Datenbanksystems. 

Das erste Produkt der Firma, SQOLBase, sorgte gleich 
für Schlagzeilen, als es 1986 vorgestellt wurde. Es war der 
erste echte Datenbankserver (im Gegensatz zu einem 
Multiuser-DBMS, das auf einem Fileserver läuft), der spe- 
ziell für Mikrocomputer gedacht war, die mit Microsoft 
Networks arbeiten. Eine erweiterte Version dieses Produk- 
tes zog kürzlich die Aufmerksamkeit der Öffentlichkeit auf 
sıch, als Lotus Development ankündigte, das dies die Basis 
für das zukünftige Lotus/DBMS-Produkt sei. 

Lotus wird natürlich seine eigenen Anwendungsent- 
wicklungswerkzeuge für Lotus/DBMS anbieten. Da das 
Lotus-System jedoch im Prinzip das gleiche Produkt ist wie 
SOLBase und auch das gleiche API (application program- 
ming interface - Anwendungsprogrammierschnittstelle) 
enthält, laufen alle Anwendungen, die in irgendeiner Spra- 
che für SQLBase geschrieben wurden, ohne Änderungen 
auch unter Lotus/DBMS. Dazu gehören auch solche An- 
wendungen, die mit Guptas SQLWindows entwickelt wur- 
den. 

»SQOLWindows arbeitet heute mit SQLBase und in 
Zukunft mit dem Lotus/DBMS-Server«, bestätigt Umang 
Gupta. »In Zukunft werden wir auch ähnliche Unterstüt- 
zung für andere Datenbankserver anbietet. Von Anfang an 
ist es ein Entwicklungsziel gewesen, daß das Produkt mit 
anderen SOL-Systemen zusammenarbeiten kann.« 


4 Microsoft System Journal September/Öktober 1988 





SsQLHindons - 


Bu —————— HR 
File Edit Outline Draw View Search Run 


+ Design-time Settings 
: ag Declarations 
örn | 1) ,.4 ne 





+ Dialog Box: Abourbox 
Title: (untitled) 
isplay Settings 
+ Contents MER 
+ Background Text: 50LWYindows 
+ Background Text: Sample "About" Bor 
* Fushbutton: Buttronük 
IETSE 106: = 
Message Action 


Sinn — 


— UN SEES N 
PETE REISEN RG 


Sample "About" Box 


ae 


Bild 1: Eine SOLWindows-Anwendung im ersten Stadium 
der Entwicklung. Es soll eine About-Box mit einer OK-Taste 
definiert werden. 





Gupta weist audrücklich darauf hin, daß der angekün- 
digte SQLServer von Microsoft und Ashton-Tate zu den 
Produkten gehört, die unterstützt werden sollen. (Über den 
SOL-Server hat das Microsoft System Journal bereits aus- 
führlich in der Ausgabe März /April 1988 berichtet.) 

»SQLWindows ist einzigartig«, fährt Gupta fort. »Es 
gibt auf dem Markt keinen Anbieter, der ein ähnliches Pro- 
dukt hat oder auch nur angekündigt hat, das auf den Pre- 
sentation Manager und Windows zugeschnitten, system- 
unabhängig und sowohl in die Fensterumgebung als auch in 
SQL eingebunden ist.« 

Eine Version von SQOLWindows für den Presentation 
Manager ist auch in Arbeit; Gupta glaubt, daß sıe ım vier- 
ten Quartal dieses Jahres fertig sein wird. Danach plant die 
Firma, sich auf den Macintosh zu konzentrieren. 

»Unsere langfristigen Pläne«, sagt Gupta, »gehen davon 
aus, daß die Zielsysteme PC und PS/2 unter dem Presenta- 
tion Manager oder Windows, der Macintosh und UNIX- 
Workstations unter einem standardisierten UNIX-Fenster- 
system sind.« Die Ausrichtung auf so viele Systeme bei 
gleichzeitiger Kompatibilität mit einer wachsenden Anzahl 
von SQL-Systemen auf dem Markt und gleichzeitig die 
Erweiterung von SQOLNet um Verbindungsmöglichkeiten zu 
anderen Großrechner-DBMS-Systemen, ıst, man kann es 
nicht anders sagen, ein ehrgeiziges Programm. Gupta Tech- 
nologies beschäftig momentan etwa 25 Leute, davon 12 
Vollzeit-Programmierer. »Wir werden unsere Entwick- 
lungs- und Vertriebsmannschaft bald erheblich vergrö- 
Bern«, meint Gupta dazu. 


Interaktive Fenster 


Gupta und Michael Geary, der Chefentwickler von SOL- 
Windows, ermöglichten dem Microsoft System Journal 
einen Blick auf eine Beta-Version ihres neuesten Produkts. 
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Bild 2: SOLWindows wird dazu verwendet, zu definieren, was 
passiert, wenn der Benutzer »OK« anklickt. Hier soll einfach 
nur zum übergeordneten Fenster zurückgekehrt werden. 


SQOLWindows besteht aus drei Hauptkomponenten: 
einem visuellen Maskenlayouteditor (ähnlich wie der 
Dialog-Editor aus dem Microsoft Windows Software 
Development Kit), einem Gliederungseditor und einer Pro- 
grammiersprache mit dem Namen SQLWindows Applica- 
tions Language (SAL). Gliederungs- und der Layouteditor 
arbeiten zusammen: Änderungen, die in einem von beiden 
Fenstern gemacht werden, bewirken eine sofortige Aktuali- 
sierung des anderen Fensters. 

Bild 1 zeigt eine Beispielanwendung unter SOLWindows 
in einem sehr frühen Stadium der Entwicklung. Der Pro- 
grammierer hat eine einfache About-Box angelegt. Die Box 
wird im Layouteditor (dem unteren Fenster in Bild 1) ange- 
zeigt, während ein Teil des entsprechenden Quellcodes aus- 
gewählt im Gliederungsfenster zu sehen ist. 

Die ausgefüllten Rauten in der Gliederung kennzeich- 
nen Überschriften, die untergeordnete Einträge haben; die 
nicht gefüllten Rauten kennzeichnen Einträge, die keine 
untergeordneten Einträge haben. Bild 1 zeigt den Eintrag 
»Contents«, der »Dialog Box: AboutBox« untergeordnet ist 
und so expandiert wurde, daß zwei Zeilen Text und eine 
Schaltfläche zu sehen sind. 

In Bild 2 ıst ein anderer Auschnitt aus dem Quellcode 
für die gleiche About-Box zu sehen. Hier geht es um die 
Schaltfläche; es sind der Titel, die Position, die Größen- 
attribute, ihre »Acceleratoren« (die Tasten, die die gleichen 
Operationen ausführen, wie das Anklicken der Fläche) und 
die »Meldungsaktionen« dieser Schaltfläche zu sehen. Im 
Zusammenhang mit dieser Anwendung ist nur ein Ereignis 
von Interesse (der Benutzer klickt die Fläche an oder 
betätigt die entsprechende Taste). Dieses Objekt benötigt 
nur eine einzige Meldungsaktion. Der Eintrag unter »Mes- 
sage Actions« besagt: »Wenn der Benutzer klickt, beende 
den Dialog und kehre zum übergeordneten Fenster (parent 
window) zurück«. 
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Bild 3: Ein Datenfeld wird mit dem Draw-Befehl von SQOL- 
Windows zum Layoutfenster hinzugefügt. Anderungen im 
Layoutfenster werden sofort im Gliederungsfenster dargestellt. 


SAM Click bedeutet, daß die Schaltfläche angeklickt 
wurde; SalEndDialog und SalParentwindow sind 
Funktionen der SOLWindows Application Language. 


Schrittweise Enthüllungen 


Gupta hebt hervor, daß SOLWindows für die Bedürfnisse 
von Programmierern entwickelt wurde und die Gliederung 
des Quellcodes diesem Entwicklungsziel gerecht wird. 

»Viele 4GLs (fourth generation language - Sprache der 
vierten Generation) gehen mit Dialogboxen an das Schrei- 
ben von Programmen heran«, sagt er. »Man fügt irgendwo 
ein Feld hinzu und sofort erscheint eine Dialogbox und 
stellt einem alle möglichen Fragen.« Der Nachteil dieses 
Arbeitsstils liegt nach Guptas Meinung darin, daß man das 
Programm nicht sehen kann, während es entwickelt wird, da 
es überall in Dialogboxen verborgen ist. »Das mag für einen 
Endbenutzer richtig sein, denn diese wollen meistens nicht 
viel vom Programm sehen. Programmierer müssen jedoch - 
zumindest manchmal - alles einsehen können. Man muß 
ihm die Möglichkeit dazu bieten, eine Art von schrittweiser 
Enthüllung. Eine Gliederung ist dafür das passende Mittel.« 

Der Entwickler Geary sagt, daß die Idee, einen Gliede- 
rungseditor in SQOLWindows einzubauen, ihm kam, als er 
die Dokumentation zu einem anderen Anwendungsent- 
wicklungssystem studierte, das nicht auf Gliederungen 
basierte. »Ich bemerkte in vielen Fällen, daß sie in der 
Dokumentation eine Gliederung zeichneten um zu erkären, 
was sie taten. Und ich dachte, wenn sie eine Gliederung 
aufzeichnen, um zu erklären, was sie tun, dann kann man 
doch gleich eine Gliederung nehmen um das zu tun, was 
man tun will.« Ein Programmierer, der SOLWindows ver- 
wendet, kann sich vollkommen frei zwischen dem Gliede- 
rungsfenster und dem Layoutfenster bewegen, je nachdem, 
welches gerade günstiger ist. 
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Bild 4: Der Programmierer kann auch direkt im Gliede- 
rungsmodus arbeiten. Anderungen im Gliederungsfenster wer- 
den sofort im Layoutfenster dargestellt. 


Die beiden Fenster sind ganz einfach zwei Darstellungen 
einer gemeinsamen Datenstruktur; Änderungen in einem 
von beiden verändern die zugrundeliegende Datenstruktur, 
was sıch sofort ım anderen Fenster wiederspiegelt. 

Die Bilder 3 und 4 illustrieren diese beiden Arbeits- 
weısen. In Bild 3 fügt der Programmierer gerade ein neues 
Datenfeld in das Layoutfenster ein, indem er die Werk- 
zeuge aus dem Draw-Menü von SQLWindows verwendet. 
In Bild 4 hat der Programmierer direkt in der Gliederung 
eine Änderung gemacht, indem er die [Ins)-Taste gedrückt 
und einfach geschrieben hat. 

Die Änderung, die der Programmierer hier durchge- 
führt hat, ıst hier nicht möglich. Ein Maskenfenster kann 
nicht in ein Menü eingefügt werden. Der Programmierer 
hat drei Möglichkeiten: zur Gliederung zurückgehen und 
den Eintrag korrigieren ((Esc)), den fehlerhaften Eintrag 
ganz herausnehmen (»No«) oder den Eintrag so zu über- 
nehmen (»Yes«). Wenn »Yes« gewählt wird, läßt SOLWin- 
dows den Eintrag an der Stelle, wandelt ihn jedoch in einen 
Kommentar um, so daß sich der Programmierer später um 
dieses Problem kümmern kann. 


Zugriff auf SOL 


Der ganze Zugriff auf SQL wird über 15 Funktionen abge- 
wickelt, die SOLWindows zur Verfügung stellt. Dazu gehö- 
ren: SQLImmediate, womit eine SOL-Anweisung sofort 
ausgeführt wird; SQLPrepare, womit eine SOL-Anweisung 
für die spätere Ausführung vorbereitet wird; SQLConnect, 
das die Anwendung mit einer bestimmten Datenbank ver- 
bindet; SQLDisconnect; SQLFetch, mit dem eine Daten- 
zeile gelesen wird; SQLFetchNext und SQLFetch- 
Previous. In Bild 5 ist die Verwendung der Funktion 
SQLImmediate zu sehen. 
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Bild 5: Der Programmierer kann SOL-Anweisungen direkt im 
Gliederungsfenster einfügen. Die Anweisung SQLImmediate 
führt SOL-Anweisungen direkt und sofort aus. 


Bei der Anwendung in Bild 5 handelt es sich um eine 
Datenbank, die Geary dazu verwendet hat, um Fehler in 
den Vorversionen von SQLWindows zu notieren. Bild 6 
zeigt eine ausgefüllte Maske als Teil dieser Datenbank. Bei 
dem ausgewählten Programmbereich handelt es sich um 
den Teil, der bei dem Befehl »New« aus dem Menü »Bug« 
ausgeführt wird. Zunächst wird eine Überprüfung vorge- 
nommen (Validatelnsert). Wenn diese negativ ausfällt, 
wird eine SAL-Meldungsbox aufgerufen. Sonst wird die 
Funktion SQLImmediate zweimal aufgerufen - beim ersten 
Mal, um die Nummer des nächsten Bugs in sequentieller 
Reihenfolge festzustellen (select(max(bugno)+1), und 
im zweiten Fall, um den Datensatz einzufügen. 

Gupta weist ausdrücklich darauf hin, daß der SOLWin- 
dows-Programmierer eine explizite Kontrolle über alle 
SOL-Anweisungen hat, die das System erzeugt. »In anderen 
4GLs«, meint er, »werden SOL-Anweisungen implizit 
erzeugt, der Programmierer oder Benutzer führt SQL- 
Anweisungen nicht direkt aus. In dem Maße, wie das der 
Fall ist, hat der Programmierer weniger oder gar keinen 
Einfluß mehr. In SOLWindows können Sie SOL-Anweisun- 
gen ganz nach Belieben ausführen, jederzeit und in beliebi- 
ger Reihenfolge.« 


Interne und externe Funktionen 


Der Aufruf von Validatelnsert in Bild 5 ist ein Beispiel 
für die »internen Funktionen« von SOLWindows. Das sind 
Funktionen, die nicht zum Repertoire der ins System einge- 
bauten Funktionen gehören, sondern vom Programmierer 
mit SAL- und SOL-Funktionen ganz nach den Erfordernis- 
sen programmiert werden können. Das System sieht auch 
externe Funktionen vor, die sich entweder in dynamischen 
Linkbibliotheken oder in statischen C-Bibliotheken befın- 
den können. 
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Bild 6: Ein Beispiel für eine fertige Eingabemaske, im Layout- 
fenster zu sehen, und die zugrundeliegende Gliederung, zu 
sehen im Gliederungsfenster. 


Bild 7 zeigt die Deklaration von Funktionen, die in zwei 
externen Bibliotheken gespeichert sind: SQLWIN.EXE und 
USER.EXE, Letztere ıst Bestandteil des Windows-Toolkkits. 
Bild 8 zeigt den Programmcode für eine interne Funktion 
mit dem Namen DoQuery, die SOL-Funktionen verwendet, 
um eine Datenzeile vorzubereiten und zu lesen. 


Warum Windows? 


Warum wählte Gupta Technologies Windows als Ober- 
fläche für SOLWindows? Wenn man den Entwickler und 
den Geschäftsführer fragt, erhält man zwei Varianten 
derselben Antwort. 

Geary meint: »Windows hat die Benutzeroberfläche, die 
ıch mag. Es ist wirklich darauf zugeschnitten, Anwendungen 
zu entwickeln, die leicht zu erlernen und dann auch leicht zu 
verwenden sind, wenn man sie erlernt hat. Windows bietet 
uns auch Tools, die wir an unsere SOLWindows-Entwickler 
weitergeben können, die wiederum damit gute Anwendun- 
gen mit einer sauberen Oberfläche entwickeln können.« 

Gupta sagt dazu: »Eine wesentliche Grundlage unseres 
Geschäfts ist, daß Benutzer einen einheitlichen Zugriff auf 
persönliche Daten, Daten der Abteilung und der ganzen 
Firma haben möchten, und daß SOL die lingua franca ist, 
die diesen Zugriff ermöglicht. Die zweite Grundlage ist, daß 
der Zugriff auf Datenbankserver von ausgefeilten Anwen- 
dungen aus stattfinden wird, die geschrieben werden, um 
die Vorteile der nächsten PC-Generation zu nutzen. Und 
das bedeutet, von dem OS/2 Presentation Manager und 
Microsoft Windows - nicht von dummen Terminals.« 

Die Technologie für »industrie-starkes Datenmanage- 
ment«, wie Gupta es nennt, ändert sich derzeit gewaltig. 
SOL wird zum Standardmedium für den Datenbankzugriff. 
Und die Verfügbarkeit von 80386-PCs und lokalen Netz- 
werken mit hoher Geschwindigkeit hat ermöglicht, daß 


SsüLlhindows - DEND. APP 
File Edit Outline Draw View Search Run = 
+ Application Description: DEM - SQOLhindows“SüLlBase Demonstration App. 
Insert, update & delete bugs in bug database. 
Gupta Technologies, Ine. 
+ Design-time Settings 
+ Global Declarations 
* External Functions 
+ Library name: SOLWIN,EXE i 
* Function: SalBreakFormWindorHlandle - 
Description: Returns the form handle at the prögran break 
(For SalEvaluate). 
| Export Ordinal: 178 
4 + Returns 
a ; Hindon Handle: HWHO 
> Parameters 
Function: $alBreakltemWindowHandle 
& Description: Returns the item handle at the program break 
(For SalEvaluate). 
© Export Ordinal: 177 
+ Returns 
> Window Handle: HWHO 
% Parameters 
Function: SalBreakProgramlounter 
% Description: Returns the program break (for SalEvaluate). 
% Export Ordinal: 172 
+ Returns 
© Number: LONG 
” Parameters 
Funetion: $SaldrinshindorToTon 
Funetion: SalllearField 
Function: Sallrestehindow 





Bild 7: Der Programmierer kann zu der SOLWindows-Umge- 
bung eigene Funktionen hinzufügen. Hier werden z.B. Funk- 
tionen aus der externen Bibliothek SQLWIN..EXE aufgerufen. 


Datenbankserver auf PCs für den Einsatz in Abteilungen 
genauso kosteneffektiv sind wie Systeme auf Minicomuter- 
Basis. 

Gupta Technologies hat einen guten Riecher für diese 
Entwicklungsrichtung bewiesen. Sie richtete sich schon früh 
auf SOL aus und entwickelte den ersten Datenbankserver 
für PCs. 

Auf der Bedienungsseite haben die Fortschritte ın der 
Beutzerschnittstellentechnologie den langsamen Anfang 
vom Ende traditioneller, auf Minicomputern basierenden, 
textorientierten 4GLs signalisiert. In den nächsten ein oder 
zwei Jahren können wir damit rechnen, Myriaden neuer 
Ansätze zur Anwendungsentwicklung von Softwarefirmen 
zu sehen, die ihre Wurzeln in der Microcomputer-Welt 
haben. OS/2 und der Presentation Manager werden eine 
wichtige Rolle bei dieser Entwicklung spielen. Durch die 
Verwendung der heute verfügbaren Windows-Technologie 
ist Gupta mıt SOLWindows ein Trendsetter ın der Presen- 
tation Manager- und OS/2-Umgebung der nicht mehr allzu 
fernen Zukunft. 


Microsoft Windows intern 


Michael Geary, der Entwickler von SOLWindows, mag die 
Programmierung unter Microsoft Windows sehr. 

»Am wichtigsten«, sagt er, »ist die Benutzerschnittstelle. 
Eine der schönen Dinge an Windows ist, daß der Windows 
Style Guide sehr detailliert eine ausgezeichnete Benutzer- 
schittstelle beschreibt. Das macht das Leben für einen Pro- 
grammierer wesentliche einfacher und es macht es auch für 
den Benutzer leichter. Wenn jemand einmal eine Anwen- 
dung erlernt hat, ist es für ihn sehr viel einfacher, eine 
andere zu erlernen.« 
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SOLWindows 


SüLHindows - DEHO.APP EI 
File Edir Outline Draw Wiew Search Bun | Fi=Helo | 
+ Application Description: DEHO - SülLWindows5üolbase Demonstration Äoo. + 
Insert, update & delete bugs in bug darabase. 
Gupta Technologies, Ine. 
+ Design-time Settings 
+ Global Declarations 
+ External Funetions 
+ Constants 
+ Nariables 
+ ] Funetio 
+ Function: DoQuery 
Description: comp 
+ Returns 
Boolean: 
Parameters 
# Local variables 
Call Sgol£Elose (hol) 
Call SalPrepare (hSal,. OrvBurf) 
Call $Solüben (hal, "ORFEUR’) 
* If SalFetchNext (hSal,nFetch) = FALSE 
|» Call Sallessageßox( "No natch to the query’, "Query", | 
Return FALSE 
HReturn TRUE 
* Function: Validatelnsert 
* Function: ClearHenuchecks 
* Function: Clearforn 
+ Function: Fixhenus 
* Apnlication Actions 
+ Form Windows: Fraleno 
= Title: - DEMO Bus Database 
Hier = En 


Bild 8: Der Programmierer kann eigene Funktionen mit 
SOLWindows SAL- und SOL-Funktionen entwickeln. Hier 
ist Beispiel für eine interne Funktion (DoQuery) zu sehen. 


Geary schätzt die Tatsache, daß Windows auch die 
Tools bietet, um diese Schnittstelle aufzubauen. »Wenn ich 
ein Menü schreiben will, brauche ich kein Programm zu 
schreiben, das weiß, wie Menüs funktionieren. Alle Grund- 
lagen und Feinheiten der Benutzerschnittstelle sind bereits 
eingebaut.« 


Meldungen und Unterfenster 


Geary, der sehr viel sowohl auf dem Macintosh als auch ın 
der MS-DOS-Umgebung programmiert hat, bevor er sich 
an SQLWindows machte (zu seinen Verdiensten gehört 
auch das vielgeschätzte Kommunikationsprogramm Trans- 
end/PC), war besonders von zwei Windows-Aspekten 
beeindruckt: Meldungen und Unterfenster. 

»Ich werde oft aufgefordert, den Macintosh und Win- 
dows miteinander zu vergleichen«, sagt er. »Vom Stand- 
punkt des Benutzers und dem des Programmierers sind sie 
sehr ähnlich. Doch mich hat es sehr beeindruckt, wie Win- 
dows die Macintosh-Vorstellung von Ereignissen genom- 
men hat und sie zum Meldungskonzept verallgemeinert hat. 
Meldungen sind wie eine Übermenge der Ereignisse. Was 
man in Windows auch machen kann und auf dem Mac nicht 
geht, ist, daß man seine eigenen Meldungen erstellen und 
von einer Anwendung zur anderen schicken kann. Das hat 
DDE (dynamic data exchange) ermöglicht; DDE ist einfach 
nur ein Protokoll für den Austausch von Meldungen.« 

Genauso bei den Unterfenstern; es gibt im Prinzip nur 
eine Fensterart auf dem Macintosh, erläutert Geary. Jedes 
Fenster ist allen anderen gleichgestellt, und wenn ein Pro- 
gramm ein Fenster aufgebaut hat, ist es Sache des Program- 
mierers, alles zu managen, was darin vor sich geht. Der Mac 
bietet auch Tools wie Push- und Radiobuttons, Scrollbalken 
uns so weiter, doch ein Programm muß die Details 
verwalten, wo sie stehen und wie sie verwendet werden. 


5 Microsoft System Journal September/OÖktober 1988 


SüLMindows - CALC.APP ie] 

File Edit Qutline Draw View Search |Run| | 
“User Node 
# If bSecondDigit = TRUE 
% Ger büoAdd = FALSE 
% Ser büolivide = FALSE 
2 Set bDofultiniv = FALSE 
% Set bDoSubtract = FALSE 
+ If nWhichFunetion = ADD 

4 Set bDoAdd = TRUE 

% Set df5ign = '#+" 
+ Else If nWhichFunction = DIUTDE 
%* Else If nWhichFunetion = HULTIPLY 
%* Else If nWhichFunetion = SUBTRACT 


“Aninate 
Slow Aninat 
Animate Bsaı Hin Calculator 

About Help 


* Els: IM 
+ If bisfirstligit = TRUE | fr 
} : 


% Application Actions 
* Form Window: frelalcularor 

% Title: 50LWin Calculator 

+ Display Settings 

+ Menu 

+ Contents 
* Data Field: dfnDisplay 
* Data Field: dfsiygn 
+ Pushbuttons: oblemary 
+ Pushbutton: pbClearHenory 
* Pushhutton: pbRecallhemary 
* Pushhbutton: pbZere 
* Pushbutton: pbüne 





Bild 9: Mit SOLWindows kann der Benutzer auch Anwen- 
dungen entwickeln, die nicht auf SOL basieren. In diesem 
Beispiel hat der Anwender einen Taschenrechner entwickelt. 


In Windows sind die gewöhnlichen Objekte, soweit es 
die Interaktion des Benutzers mit der Anwendung angeht, 
zum Beispiel die verschiedenen Bestandteile einer Dialog- 
box, typischerweise als Unterfenster implementiert. Und da 
Unterfenster im Prinzip ganz genauso funktionieren wie 
Hauptfenster, passieren eine Menge Dinge automatisch, die 
auf dem Macintosh explizite Programmierung erfordert 
hätten. 


Unterklassen 


»Was ıch noch an dem Unterfensterkonzept mag,« fügt 
Geary hinzu, »ist, daß Windows einem eine Reihe von vor- 
definierten Klassen von Unterfenstern zur Verfügung stellt 
und es dann einfach macht, sie unter einem Fenster anzu- 
ordnen. Man nimmt einfach eine vordefinierte Klasse und 
fügt ein wenig eigenes Verhalten hinzu, indem man seine 
eigenen Fensterfunktionen vor die schiebt, die es bereits 
gibt und so effektiv die Meldungen herausfiltern kann, die 
man anders behandeln möchte.« 

Geary hat diese Technik bei der Programmierung von 
SQLWindows sehr viel verwendet. Objekte im Layouteditor 
müssen anders reagieren, wenn der Benutzer von SOLWin- 
dows eine Anwendung entwickelt als wenn der Endbenutzer 
mit der Anwendung arbeitet. Der Entwickler muß auf 
solche Objekte wıe Pushbuttons klicken können, um die 
Größe zu verändern oder sie zu verschieben; beim Endbe- 
nutzer sollen sie aber wie gewöhnliche Pushbuttons funk- 
tionieren. 

»Ich konnte dieses gespaltene Verhalten realisieren, 
indem ich einfach die Unterklassen-Technik verwendet 
habe«, erklärt Geary. »Ich stelle meine eigene Fensterfunk- 
tion vor die Standardfunktion. In der Entwicklungsphase 
behandle ich viele Meldungen anders; zur Laufzeit lasse ich 
sie einfach durch.« 
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Bild 10: Ein weiteres Beispiele für eine SOLWindows-Anwen- 
dung, die auch ohne Datenbankzugriffe auskommt: Die Um- 
rechnung von Währungen. 


Geary sagt, daß er eine Reihe von Fensterklassen von 
Grund auf neu erstellt hat, unter anderem ein Listenfenster, 
daß Spalten genauso behandeln kann, wie Zeilen, in etwa so 
wie in einer Tabellenkalkulation, und dabei noch Daten aus 
der Datenbank lesen kann (eine »normale« Windows-An- 
wendung erwartet, daß alle diese Daten im Speicher sind). 

»Das schöne daran ist«, führt er aus, »daß meine eige- 
nen Fensterklassen mit den eingebauten Windows-Klassen 
koexistieren und es gibt nicht viel Besonderes, was ich tun 
muß, um meine Objekte Seite an Seite mit den vorhan- 
denen arbeiten zu lassen. Der Rest meines Programms 
behandelt sie alle gleich; es kümmert sich nicht darum, ob 
das Fenster von mir stammt oder von Windows.« 


Ressourcenverwaltung 


Andere Vorteile der Programmierung für Windows sind in 
der Speicherverwaltung und der Tastaturbehandlung zu 
sehen. Da jedes Programm unter Windows relokatier- und 
auslagerbar ist, ist der Programmierer laut Geary von Pro- 
blemen wie der Speicherzerstückelung und dem Jonglieren 
mit Programmoverlays befreit. 

»In Programmen, die ich in der Vergangenheit 
geschrieben habe,« so erklärt er, »mußte ich häufig Over- 
lays verwenden. Und es ist immer schwierig zu entscheiden 
gewesen: Wie stark setze ich Overlays ein? Wie groß ist die 
Zielmaschine? Für wen optimiere ich” Ich habe diesen 
Prozeß mehrere Male durchgemacht und es ist schrecklich. 
Man kann es nicht allen recht machen.« 

»Doch ın Windows braucht man ein Programm nur in 
eine Reihe von Codesegmenten aufzuteilen. Jedes Code- 
segment ist, was das Laden in den Speicher angeht, eine 
unabhängige Einheit und Windows lädt einfach so viele, wie 
passen. Wenn kein Platz mehr da ist, verschiebt es sie oder 
löscht sie aus dem Speicher, ganz wie es erforderlich ist. 
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Bild 11: Die Universaität einer Programmiersprache läßt sich 
sehr gut damit demonstrieren, daß man damit auch interakti- 
ve Spiele programmieren kann. 


Mit anderen Worten, es optimiert für all die verschiedenen 
Systeme auf einmal.« 

»Man muß etwas mehr Arbeit hineinstecken, um Vor- 
teile aus der Speicherverwaltung von Windows zu ziehen, 
doch das ist sehr viel besser, als es mit einer starren Over- 
laystruktur zu tun zu haben.« 

Genau wie bei der Speicherverwaltung begrüßt Geary 
die Tatsache, daß Windows den Programmierer mit Infor- 
mationen versorgt, die die Notwendigkeit der direkten 
Hardwareprogrammierung überflüssig machen. 

»In Windows«, sagt er, »ist die Tastaturbehandlung sehr 
einfach. Es werden einem Meldungen für alles geschickt. 
Mit jedem Tastendruck erhält man WM_KEYDOWN. Wenn 
eine Taste losgelassen wird, erhält man WM_KEYUP. Man 
kann zwischen der ersten Betätigung einer Taste und sol- 
chen, die durch den Auto-Repeat-Mechanismus der Tasta- 
tur entstanden sind unterscheiden. 

»Im Grunde kann man die Tastatur auf jeder 
gewünschten Ebene behandeln, ohne ein ’unsauberes’ Pro- 
gramm zu sein. Es gibt keinen Grund, direkt auf die Hard- 
ware zu gehen, denn es sind alle Dinge vorhanden, die man 
braucht, um das zu tun, was man tun will.« 

Schließlich weist Geary noch auf die Vorteile hin, die, 
für Programmierer und Benutzer gleichermaßen, durch 
DDE und die Zwischenablage von Windows entstehen. Er 
glaubt, daß ein gut definierter Standard für die Kommuni- 
kation zwischen Anwendungen einen großen Einfluß darauf 
haben wird, welche Art von Software die Leute entwickeln 
werden. 

»Philosophisch betrachtet ermöglichen die Zwischenab- 
lage und DDE den Leuten, davon wegzukommen, komplexe 
Alles-in-Einem-Programme zu bauen und sie öffnen den 
Weg dahin, kleinere Programme zu erstellen die effektiv 
zusammenarbeiten.« 

Craig Stinson 
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Eine Systemutili r Windows: 


Screen-Save-Funktion für MS-Windows 


In diesem Artikel wird eine Applikation für MS- 
Windows entwickelt, die nach einer einstellbaren 
Zeit des »Nichtstuns« am Rechner (keine Tasta- 
tur- oder Mauseingabe) den Bildschirm dunkel 
schaltet, bis wieder eine Eingabeaktion stattfin- 
det. Hierbei wurde durchgängig auf die Mög- 
lichkeiten von Windows 2.03 zurückgegriffen. 
Unter anderem wird der Systemzeitgeber ver- 
wendet und System-Eingriffe (sogenannte 
Hooks) vorgenommen. 


Aufgabe einer Screen-Save-Funktion 


Wird längere Zeit an einem eingeschalteten Rechner nicht 
gearbeitet, besteht die Gefahr, daß sich die ständig ungeän- 
derte Bildschirmanzeige in den Bildschirm »hineinfrißt«, 
d.h. in der Phosphorschicht der Röhre häßliche Flecken 
zurückläßt. Dies gilt vor allem dann, wenn längere Zeit hell 
leuchtende Bereiche angezeigt werden. Da bei MS-Win- 
dows häufig »schwarz auf weiß« gearbeitet wird, sollte 
daher hier auf jeden Falle bei Eingabe-Pausen der Bild- 
schirm abgeschaltet werden. Schön wäre es, wenn dies auto- 
matisch geschehen würde, d.h. wenn das System erkennt, 
daß längere Zeit nichts eingegeben wurde, es den Bild- 
schirm ausschaltet. Sobald die Arbeit wieder aufgenommen 
wird (eine Taste gedrückt oder die Maus bewegt wird) soll 
der Bildschirm wieder einschaltet werden, wobei natürlich 
die alte Information wieder zu sehen sein soll. Diese Auf- 
gabe wird von sogenannten Screen-Save-Programmen über- 
nommen, die fast jeder EGA- oder VGA-Karte beigelegt 
werden. 

Unter DOS arbeiten solche Programme nach folgendem 
Prinzip: Es wird der System-Tick (Interrupt ICH, meldet 
sich jede 1/18 Sekunde) und der Keyboard-Interrupt (09H, 
meldet sich, wenn eine Taste gedrückt oder losgelassen 
wird) umgelenkt und ausgewertet. Wurden so viele System- 
Tick-Nachrichten gezählt, daß eine bestimmte Zeitspanne 
(zum Beispiel 5 Minuten) verstrichen ist und währenddes- 
sen keine Taste gedrückt worden ist, wird der Video-Signal- 
Ausgang abgeschaltet (Screen-Save), so daß der Bildschirm 
nun schwarz ist. Sobald wieder eine Taste gedrückt wird, 
wird der Ausgang sofort wieder eingeschaltet, so daß der 
alte Bildschirminhalt erneut sichtbar ist. Dieses Verfahren 
hat mehrere Nachteile: 


= Da der Bildschirm während der Save-Phase komplett 
schwarz ist, läßt sich nicht mit einem Blick feststellen, ob 
nun der Monitor mit dem Netzschalter ausgeschaltet 
worden ist oder lediglich vom System abgeschaltet 
wurde. Man vermißt einen kleinen hellen Fleck oder 
ähnliches am sonst schwarzen Bildschirm, der eindeutig 
auf den gesicherten Bildschirm-Status hinweist. 
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Bild 1: ScrSave nach dem Aufruf 


= Weil lediglich der Tastatur-Interrupt als Aktivitätsmel- 
der verwendet wird, wird bei einer intensiven Mausbe- 
nutzung (zum Beispiel in einem CAD-Programm) der 

Bildschirm ausgeschaltet, obwohl gearbeitet wird. Dies 

ist störend und führt leicht zu Fehleingaben. 
= Das größte Problem ergibt sich jedoch bei Verwendung 

der erhältlichen Screen-Save-Funktionen unter Win- 
dows. Hier werden auch Tastendrücke nicht mehr als 

Aktivität erkannt, da das Windows-System den Tastatur- 

Interrupt umlenkt und sich nicht mehr darum kümmert, 

daß eine Screen-Save-Funktion auf diesen Interrupt 

wartet. So schaltet sich dann auch bei intensiver Tasta- 
tur-Benutzung in Windows nach der eingestellten Zeit 
der Bildschirm ab und läßt sich ohne weiteres nicht 
mehr reaktivieren (Tip: Drücken Sie in einem solchen 

Fall zur Reaktivierung des Bildschirms zum Beispiel die 

Scroll- oder die Shift-Lock-Taste). 

Man kommt also nicht herum, für Windows eine neue 
Screen-Save-Funktion zu schreiben, die dann natürlich eine 
echte Windows-Applikation ist. Wie häufig beim Übergang 
von DOS zu Windows ergeben sich dabei völlig andere 
Lösungsansätze und auch völlig andere Probleme. 


Lösung unter MS-Windows 


Man kann sich die Sache einfach machen und innerhalb von 
Windows den Tastatur-Interrupt und den Maus-Eingabe- 
Interrupt (des seriellen Schnittstellentreiber COM1 oder 
COM?) wie bei der DOS-Funktion umlenken und entspre- 
chend den Bildschirm abschalten. Doch würde eine solche 
Lösung einem wichtigen Windows-Prinzip widersprechen, 
der Hardware-Unabhängigkeit. 

Diese wird dadurch erreicht, daß man als Aktivitäts- 
kontrolle alle Windows-Nachrichten (Messages) abfängt, 
die als Folge einer Eingabe an die Applikationen gesandt 
werden und statt der Video-Signalabschaltung den Bild- 
schirm explizit schwarz zeichnet. Natürlich muß bei der 
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Reaktivierung des Bildschirms dafür gesorgt werden, daß 
der alte Bildschirm wieder vollständig dargestellt wird. Naiv 
könnte dies dadurch geschehen, daß man den Bildschirm 
vor dem Schwarz-Zeichnen Punkt als Punktbild (Bildmap) 
in einen Puffer liest, den man bei der Reaktivierung wieder 
ausgibt. Das hat jedoch unter Windows einen Haken: Die 
Bildschirmdaten können unter Umständen sehr umfang- 
reich sein (zum Beispiel 256 Kbyte). Soviel Speicher wird 
aber oft von Windows gar nicht zur Verfügung gestellt. Man 
müßte eine umfangreiche und komplizierte Datenauslage- 
rung auf Platte vornehmen. Jede Bildschirm-Abschaltung 
und Reaktivierung würde viel Zeit in Anspruch nehmen. 

Die Lösung ist zunächst viel einfacher, als Sie wahr- 
scheinlich denken. Schließlich muß unter Windows jede 
Applikation ihr Bildschirmfenster selbst reaktivieren kön- 
nen. Dies wird zum Beispiel jedes Mal dann gemacht, wenn 
eine Applikation von der Vollbild-Darstellung auf die Sinn- 
bild-Darstellung verkleinert wird. Man wird also einfach 
dadurch den Bildschirm schwarz zeichnen, indem man die 
Screen-Save-Applikation zum Vollbild vergrößert, dieses 
komplett schwarz malt und ihn wieder reaktivieren, indem 
die Applikation zum Sinnbild verkleinert wird. Die Neu- 
zeichnung des Bildschirms erfolgt dann durch die einzelnen 
angezeigten Applikationen bzw. die Hintergrund-Applika- 
tion ohne daß man sich darum explizit kümmern müßte. So 
viel zur Windows-Theorie. 

Wer seit längerer Zeit unter Windows programmiert, 
weiß, daß wegen dessen Komplexität Theorie und Praxis oft 
verschiedene Wege gehen. Man denkt sich eine tolle Sache 
aus, die, wenn man die Philosophie von Windows verstan- 
den hat, eigentlich funktionieren müßte und stellt dann 
beim ersten Probelauf fest, daß alles ganz anders ist. 
Ursprünglich hatte ich vorgehabt, das Applikationsfenster 
so zu definieren, daß es als Vollbild keinen Rand besitzt 
und somit der (schwarze) Zeichen-Bereich (Client-Area) 
den gesamten Bildschirm ausfüllt. Doch so sehr man sich 
bei der Zusammenstellung der CreateWindows-Optionen 
auch abplagt: Man schafft es nicht, ein Applikationsfenster 
ohne Rahmen und Titelbalken (Title bar, Capion bar) zu 
erzeugen. Im zweiten Ansatz hatte ich vor, den Fenster- 
Rahmen (die sogenannte Non-Client-Area) explizit schwarz 
zu zeichnen, ein aufwendiges Unterfangen. 

Beim Analysieren der vorhandenen Windows-Nach- 
richten ergab sich eine viel einfachere Lösung: Die Nach- 
richt WM_NCCALCSIZE übergibt die Größe des Applikati- 
onsfenster einschließlich Rahmen (bei Vollbild-Darstellung 
also der gesamte Bildschirm). Normalerweise übergibt eine 
Windows-Applikation diese Nachricht unverändert an Def- 
WindowProc. Diese verkleinert dann die Fenstergröße 
durch Abziehen der eingestellten Rand- und Capture-Breite 
auf die Client-Area-Größe. Wenn man nun einfach bei 
WM_NCCALCSIZE die Fenstergröße unverändert zurückgibt, 
nimmt die Client-Area das gesamte Applikationsfenster und 
damit bei Vollbild-Darstellung den gesamten Bildschirm 
ein. Soweit die Technik zum Abschalten des Bildschirms. 
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Bild 2: ScrSave nach dem Sichern des Bildschirms 


Die Erkennung, ob eine Eingabe vorliegt, ist ebenfalls 
nicht ganz einfach. Schließlich gilt es ja nicht, die Eingabe- 
Nachricht für die Screen-Save-Applikation allein zu erken- 
nen, sondern die Eingabe-Nachrichten für alle geladenen 
Applikationen. Hierzu bedient man sich eines Systemein- 
griffs, mit dem man alle gewünschten Nachrichten zum 
Analysieren umlenkt, bevor sie an die einzelnen Applikatio- 
nen verteilt werden. Unter Windows wird hierzu die Funk- 
tion SetWindowsHook verwendet. Hier funktioniert offen- 
sichtlich einiges anders, als es im Windows-Referenz- 
Handbuch beschrieben wird. Doch besprechen wir zunächst 
den Rahmen der Applikation ScrSave. 


Die Applikation ScrSave 


Nach dem Aufrufen der Applikation ScrSave 
(einzudeutschen zum Beispiel als BildAus) verkleinert sie 
sich zu einem Sinnbild, dem einzigen konventionellen Fen- 
sterzustand, den sie annehmen kann. Zu Anfang erscheint 
jedoch eine Dialogbox (Bild I), in der angegeben werden 
kann, ob die Funktion aktıv sein soll und die gewünschte 
Zeit eingetragen werden kann, nach wieviel Minuten 
»Nichtstun« der Bildschirm abgeschaltet wird. Die Stan- 
dardwerte werden aus WIN.INI eingelesen. Nach dem 
Schließen der Applikation werden entsprechend die zuletzt 
eingestellten Werte in WIN. INI zurückgeschrieben. Ist die 
eingestellte Zeit verstrichen, wird der Bildschirm abge- 
schaltet (mit Schwarz gefüllt). Um zu erkennen, daß er 
dennoch physikalisch eingeschaltet ist, erscheint im unteren 
Bildschirmbereich die Sanduhr. Damit sich nun nicht diese 
an ihrer Abbildungsstelle in den Bildschirm »einfrißt«, wird 
sie langsam vom linken zum rechten Bildschirmrand und 
zurück bewegt. Sobald die Maus bewegt wird oder eine 
Taste gedrückt wird, wird der alte Bildschirminhalt sofort 
wieder angezeigt und der Cursor steht wieder auf der alten 
Eingabeposition, als wäre sonst nichts geschehen. 


Die Quelldateien der Applikation 


Bild 3 zeigt SCRSAVE.C, das C-Programm der Applikation. 
Da es sich um eine international anwendbare Applikation 
handelt, wurden alle landessprachenabhängigen Teile in die 
Resourcen-Datei SCRSAVE.RC (Bild 4) verlagert. Man 
kann daher die Applikation für andere Länder anpassen, 
ohne daß hierzu der Quellcode nötig wäre. Letzteres ist in 
Zukunft bei Programmentwicklungen für den europäischen 
Binnenmarkt sehr wichtig. 

Zeichenketten aus der Resource-Datei werden mit 
LoadString in das C-Programm geladen. Die Definiti- 
onsdatei für den Linker, SCRSAVE.DEF, ist in Bild 5 darge- 
stellt. Alles wird mit der MAKE-Datei in Bild 6 übersetzt 
und gelinkt. Vorher müssen Sie allerdings noch das Sinnbild 
der Applikation SCRSAVE.ICO eingeben, Bild 9 zeigt es in 
seiner »Entwicklungsumgebung«, dem ICONEDIT. 

Soweit vieles, was bereits von anderen Windows-Pro- 
grammen bekannt ist. Im folgenden soll auf die Besonder- 
heiten der Applikation eingegangen werden. 


Das Hauptprogramm WinMain 


Zum Hauptprogramm der Applikation gibt es nicht viel zu 
sagen: Zunächst wird der Initialisierungs-Teil der Applika- 
tion aufgerufen. Anschließend wird die bekannte Windows- 
Nachrichten-Bearbeitungsschleife aufgerufen, die bis zum 
Beenden der Applikation die Nachrichten an die Windows- 
Funktion fwMain weitergibt. Die Aufteilung in Hauptpro- 
gramm und Initialisierung sieht etwas künstlich und viel- 
leicht auch umständlich aus. Beim Autor wird jedoch jede 
Windows-Applikation von einem festen Rahmen ausgehend 
entwickelt und die Initialisierung wurde vom Hauptpro- 
gramm getrennt, da bei größeren Applikationen der Initiali- 
sierungscode in einem getrennten Modul abgelegt wird, 
welches im Gegensatz zu WinMain und fwMain als ent- 
fernbar aus dem Speicher (DISCARDABLE) definiert wird. 
Die Auftrennung in Module wäre auch bei ScrSave sinnvoll, 
es wurde jedoch der Übersichtlichkeit wegen darauf ver- 
zichtet. 


Initialisierung der Applikation 


Jede Windows-Applikation unterscheidet zwischen zwei 
Arten der Initialisierung: Die Initialisierung des ersten 
Vorkommens der Applikation und die Initialisierung jedes 
weiteren aufgerufenen Vorkommens. Erstere wird in der 
Funktion InitWindow vorgenommen, die zweite in Init- 
Instance, In InitWindow wird zunächst die Fenster- 
klasse definiert. Man beachte die Hintergrundfarbe 
»schwarz« und den Verzicht auf einen vordefinierten 
Cursor. Anschließend werden benötigte Daten aus 
WIN.INI geladen. Dies erfolgt in der Funktion LoadWin- 
IniData durch Verwendung der Windows-Funktionen 
GetProfileInt und GetProfileString. 


| FR 8 a0 38-30-8000 EEE EEE EEE DE DE DEDEDE BEE EEEEEEBEDENEENEEHEEEHE 


This MS-Windows APPS aNLn writes the complete screen black 
after a delay without any mouse movement or key pressing and 
reactivates it if a key is pressed or the mouse is moved. 
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Copyright 1988 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-75080 Karlsruhe 1 
Phone (#) 721/37 67 76 (West Germany) 


All rights reserved --- Release 1.00 of 88-Aug-B1 
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define NOMINMAX 
include <WINDOWS.H> 
#include <stdlib.h> 
#include a 
\#include "DEFS.H” 


| es 


= Application Variables 


BEENDEN BEENDEN NENNE EEE EEE EEE BEE BEER 


char zAppName[] = "SCRSAVE”; 
char zAppTitlel4#]; 


|/* Delay time in minutes betw. no action and screen saving. %/ 


/* Application name #/ 
/* Application title */ 


int vSaveDelay; 
int vWIDelay; /* copy of WIN.INI value */ 


/* Flag: non-zero if screen saving mode is active */ 


BOOL bSaveActive; 
BOOL bWIActive; /* copy of WIN.INI value */ 


/* Minutes Tick Count value for determing Screen Off */ 
int vSaveTick; 

/* Flag: non-zero if screen is saved */ 

BOOL b5avedScreen; 

|/* Last input event cursor point */ 

POINT pEventCursor; 

|/* Screen size values */ 

int sxScreen; 

int syScreen; 


int sxCursor; 
int syCursor; 


HANDLE hiMain; /* Instance of application *#/ 
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Window & Dialog Procedure Pointers 
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*/ 
FARPROC rfdMode; 
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|FARPROC rfhEvent; 
FARPROC rfhPrevEvent; 
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Application defined Messages 






AM ACTIVATE: sent if a screen must be repainted 
AM_SAVE: sent if a screen must be saved 





5 


“define AM_ACTIVATE WM_USER 
|#define AM_SAVE (WM _USER+1) 















EEE 





ka Jap Gans nn —-— Anplication specific functions ———- 
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ErrorNoMen 
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The error nn "Not enough memory” is displayed in a message | 
box. Normally, the error string is read as a string resource by 

the index <STNOMEM>. But if no string exists, the message is 
printed in English. 











Parameters: 
hw is the window handle and NULL if no window exists. 





Return: 
None 






IE EEE EI U 2.2 2.802 2.20 2.2.2 2.2.8.0 02.2 2.2.2.2.2.2.8.2.2.3 2.2.5025. 8.2.2.3 202.02.2.3020808.80218020202.02.77 





void ErrorNoMen {hw) 
HWND hw; 





| {char zBuf[88]; 
int s; 











s=LoadString(hiMain, STERROR  zBuf ,sizeof({zBuf)); 

if (s==8) strepy(zBuf,"Not enough memory.”); 

| MessageBox(hwMain,zBuf,zAppTitle,MB_ICONEXCLAMATIONIMB OK); 
} /* ErrorNoMen(} */ ö 







Fr BRRBRRBBBBBEIEI III III 


setMode 


=-SSEEBEZZZZZZZEEEEIZBBEBE BES SS FF SSSSESEZZZESZg Eee ereseszsss25ss2 2.225 












This functions sets the current screen mode. 
|Two modes are possible: 

1) bSave=FALSE: The active-screen mode is set if <bActive> is 
TRUE. The timer sends a message every minute. 
The event hook analyses all events and each 
event resets the save-delay-counter. If 
<bActive> is FALSE, never timer nor event hook 
are set. 

The screen-saved mode is set. The screen is 
painted black (except the walking hourglass 
cursor). The timer sends a message every cursor 
walking step. The event hook is set. Each event 
stops the screen-saved condition. 











I2) bSave=-TRUE: 
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Werden die entsprechenden Einträge delay und save 
im Block screen save nicht gefunden, werden die Ersatz- 
werte »5« (Minuten) und »yes« verwendet. Die Original- 
werte aus WIN.INI werden getrennt abgelegt (in vWI- 
Delay und bWIActive), damit bei einer Beendigung der 
Applikation festgestellt werden kann, ob WIN. INI mit den 
eventuell neu gesetzten Werten aktualisiert werden muß. 

Eine dritte Aufgabe von InitWindow besteht darin, 
verwendete Systemgrößen zu bestimmen. Bei Scr$ave wird 
die Größe des Bildschirms und eines Sinnbildes benötigt. 
Solche Werte werden mit GetSystemMetrics ermittelt. 

Die weitere Initialisierung wird in InitInstance vor- 
genommen. Hierbei ist eine kleine Besonderheit zu beach- 
ten: Es macht wenig Sinn, mehrere Vorkommen von Scr- 
Save aufzurufen. Aus diesem Grund wird ein weiterer 
Aufruf von Scr$ave abgeblockt, indem eine Hinweis-Box 
ausgegeben und die neue Vorkommen wieder beendet wird. 

Nach dem Erzeugen des Prozedur-Vorkommens mit 
ProcInstance wird mit CreateWindow das Applika- 
tionsfenster angelegt. Kann das Fenster nicht angelegt 
werden und wird NULL zurückgegeben, ist höchstwahr- 
scheinlich zu wenig Speicher vorhanden. In diesem Fall wird 
eine Fehler-Hinweis-Box in der Funktion ErrorNoMem 
ausgegeben und die Applikation beendet. 

Als nächstes wird das System-Menü durch zwei Einträge 
CMD_TURNOFF (»Bildschirm aus«) und CMD_MODE (»Ein- 
stellungen...«) vergrößert. Der erste dient zum expliziten 
und sofortigen Abschalten des Bildschirms. Stattdessen 
kann auch das Applikations-Sinnbild doppelt angeklickt 
werden. Durch den zweiten Aufruf können die Applikati- 
onsparameter in einer Dialogbox geändert werden. Beide 
Einträge mußten ins System-Menü gelegt werden, da es nur 
aus dem Sinnbild heraus aufgerufen werden kann. 

Nachdem alles definiert ıst, wird das Applikationsfenster 
mit ShowWindow als Sinnbild angelegt. Nun muß noch, wie 
eingangs erwähnt, die Dialogbox mit den Einstellungen auf- 
gerufen werden. Dies erfolgt jedoch nur, falls der Ein- 
gangsparameter vCmdShow nicht SW_SHOWMINNOACTIVE 
ist. Damit ist sichergestellt, daß die Dialogbox nur beim 
expliziten Aufruf der Applikation aus MS-DOS heraus 
angezeigt wird, nicht jedoch, wenn sie aus dem LOAD-Feld 
von WIN. INI beim Starten von Windows geladen wird (was 
der normale Aufruf von Scr$Save sein dürfte). 


Die Dialogbox-Funktion fdMode 


Die Verwaltung der Nachrichten für die Mode-Dialogbox 
(»Einstellungen...«) ist im großen und ganzen Standard. Die 
eingestellten Werte werden beim Verlassen der Dialogbox 
analysiert. Der Eingabewert für die Verzögerung muß im 
Bereich 1 bis 99 liegen. Der obere Wert wird durch die 
Länge des Editierfelds garantiert. Bei 0 oder anderen feh- 
lerhaften Eingaben wird ein Piepser ausgegeben, der Ein- 
gabefokus auf das fehlerhafte Feld gesetzt und das Verlas- 
sen der Box abgebrochen. Andernfalls werden die neuen 





Windows 


Werte in globalen Variablen abgelegt. Wurde statt »OK« 
das Feld »Beenden« (IDEXIT) gewählt, wird eine WM_DE- 
STROY-Nachricht an das Hauptfenster geschickt. Damit 
wird die Applikation beendet. 

In SCRSAVE.RC steht in der Definition der Dialalogbox 
noch eine Besonderheit, die auf einen Windows-Implemen- 
tierungsfehler hinweist: Damit die Dialogbox an derselben 
Stelle wie das Menü der Applikation steht (oberhalb des 
Sinnbilds) wurde als Y-Position der Dialogbox ein negativer 
Wert eingegeben. Die Anzeige erfolgt auch wie gewünscht. 
Steht das Sinnbild jedoch am oberen Bildschirmrand, wird 
zwar das Systemmenü ordnungsgemäß nach unten verscho- 
ben, so daß es vollständig im Bildschirm steht, nicht aber 
die Dialogbox. Bei dieser ist nur noch. der untere Rand 
sichtbar. Wenn man weder die OK- noch die Beenden- 
Taste drücken kann, hängt sich die Applikation gewisser- 
maßen auf. Da eine Sinnbildposition am oberen Bildschirm- 
rand aber sehr ungewöhnlich ist, wurde die ungewöhnliche 
Dialogbox-Position beibehalten. 


Die Windows-Funktion fwMain 


Wie bei fast allen Windows-Applikationen steht auch der 
Kern von ScrSave in der Windows-Funktion, beim Autor 
fwMain genannt. Hier werden alle vom System empfange- 
nen Nachrichten verarbeitet, sofern sıe für die Applikation 
von Interesse sind. Zusätzlich wurden noch zwei Nachrich- 
ten vereinbart, die aus verschiedenen »Ecken« des Pro- 
gramms an fwMain geschickt werden. Dort erfolgt dann 
zentral dıe Auswertung der Nachrichten. Die Kommunika- 
tion mit selbstdefinierten Nachrichten innerhalb einer 
Applikation verbessert erheblich die Strukturierung eines 
Programms, insbesondere dann, wenn eine Nachricht nicht 
sofort bearbeitet werden muß, sondern »hinten angestellt« 
werden kann (abgesandt mit PostMessage). 

Beginnen wir zunächst mit der Erläuterung der Stan- 
dard-Nachrichten. WM_CREATE speichert lediglich den Fen- 
sterbezug (Window-Handle) an eine globale Variable, 
damit in der gesamten Applikation problemlos darauf zuge- 
griffen werden kann. WM_NCCALCSIZE ermittelt normaler- 
weise aus der Fenstergröße die Größe des Zeichenbereichs 
(Client-Area). Wie oben erwähnt wird durch Rückgabe von 
0 dieser auf die gesamte Fenstergröße ausgedehnt, aller- 
dings nur, wenn tatsächlich der Bildschirm abgeschaltet 
werden soll und bSavedScreen TRUE ist. Bei WM_SYS- 
COMMAND werden alle Befehle aus dem Systemmenü verar- 
beitet. Jeder Versuch, das Fenster irgendwie zu öffnen oder 
die Wahl des Turn-Off-Befehls (»Abschalten«) führt zum 
Abschalten des Bildschirms. Dies erfolgt dadurch, indem 
die Nachricht AM_SAVE an fwMain selbst gesandt wird. 
Wird der Mode-Befehl (»Einstellungen...«) gewählt, muß 
vor dem Aufruf der Box unbedingt die Abschalt-Automatik 
abgeschaltet werden, sonst hängt sich die Applikation auf, 
nachdem der Bildschirm gesichert wurde. Auch dies stellt 
vermutlich einen Implementierungsfehler bei Windows dar. 










|Parameters: 

Save is the mode flag: FALSE for setting mode "active"; 
TRUE for setting mode "saved”. 

determines if the the active/save mode is valid or 

not. 4 <bActive> is zero, no timer or event hooks 

are set. 







bActive 







Return: 
None 
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void SetMode (bSave,bActive) 
BOOL bSave; 
BOOL bActive; 


{static BOOL bEventSet=FALSE; 
static WORD iCurrentTiner=#; 
WORD vDuration; 


if {iCurrentTimert=#) 
{/* destroy timer */ 
KillTimer(hwMain,1); iCurrentTiner=#; 
I /r if * 
if (bEvent$et) 
{/* destroy current event hook */ 
UnhookKindowsHook ({HH_JOURNALRECORD,rfhEvent); 
bEventSet=FALSE; 
iR if %#/ 
/* mode not active => return #/ 
if (!bActive) return; 

if (bSave) 

(/* set timer for saved mode #/ 

/* per second one full cursor movement */ 
VINEBLEORSVEN/STUUEREN, 































else 
[{/* set timer for active screen mode */ 
vDuration=6ß800; /* one minute */ 
J /R it 
/* Set timer with specified duration #/ 
iCurrentTiner=SetTiner (hwflain, 1,vDuration, NULL); 
if (1CurrentTiner==P) | 
{/* Timer not set(too many timers started): print message *#/ 
char zBuf[6#]; 
LoadString(hiMain,STTIMEOVL , zBuf,sizeof(zBuf)); 
MessageBox(hwilain,zBuf ,zAppTitle,MB_ICONEXCLAMATIONIMB_OK); 
return; 
I /r if 
/* set event hook */ 
rfhPrevEvent=SetWindowsHook (WH_JOURNALRECORD, rfhEvent) ; 
bEventSet=TRUE; 
} /* SetMode() */ 
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fdMode 
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This function processes all messages for the "Mode" dialog box. 






Parameters: 
see definition of fwMain 
Return: 

none 
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BOOL FAR PASCAL fdMode(hw,ufisg,WP,LP) 
HWND hw; 

WORD uisg; 

WORD WP; 
DWORD LP; 
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Windows 













| {BOOL b; 


switch Kari 
{case WM INITDIALOG: 
CheckDlgButton(hw, IDACTIVE,bSaveActive); 
setDlgItenInt(hw, IDDELAY vSaveDelay, FALSE); 
return TRUE; 
case WM COMMAND: 
switch (WP) 
{case IDEXIT: 
case IDOK: 
/* check & save edit fields */ 
bSaveActive=IsDlgButtonChecked(hw, IDACTIVE); 
vSaveDelay=GetDlgItenInt(hw, IDDELAY,&b, FALSE); 
if (tbi|vSaveDelay==ß) 
{/* illegal delay value: focus to error location */ 
MessageBeep(NULL); 
SetFocus(GetDlgIten(hw, IDDELAY)); 
/* mark full buffer */ 
SendDleItemMessape 
(hw, IDDELAY,EM SETSEL,8,MAKELONG(0,32767)); 
break; /* don't quit dialog box */ 
I /r if #/ 
if (WP==1DEXIT) 
{/* send WM DESTROY message to application window */ 
PostMessage (hwMain,WM DESTROY,8,8L); 
Y/R if 
EndDialog(hw, FALSE); 
return TRUE; 
} /* switch %/ 
} /* switch %/ 
return FALSE; 
ı 3 /* £dMode() */ 




































Nr 
fhEvent 
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ı This function processes all event messages of the Windows 
Systems. Each valid event resets during the "Active Screen 

Phase" the screen save delay vounter and activates the screen 
during the "Screen Save Phase". 












Parameters: 
Code contains the kind of message. 
WP is the WORD Parameter. 

LP is the DWORD Paraneter. 












Return: 
The event hoock result is returned. 
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DWORD FAR PASCAL fhEvent (vCode ,WP,rv) 
int vCode; 
WORD WP; 
WORD far *rv; 


{HORD uMsg; 








if (vCode<B) 
{/* Default action */ 








return 
DefHookProc (vCode ,WP,{LONG)rv, (FARPROC FAR*) 
&rfhPrevEvent); 
y fr if 






uMsg=*rv; /* message code */ 
if (uMsg!=WM MOUSEMOVE && uMsg!=WM KEYDOWN && 
uMsgt!=KM LBUTTONDOWN && uMsgt!=HM RBUTTONDOWN && 
uMsg!=WM MBUTTONDOHN ) 
{/* no valid event message */ 
return BL; 
I fr if“ 
if (uMsg=-=WM MOUSEMOVE) 
{/* special condition "nouse moved” */ 
RECT wre; 
POINT pNewLoc; 
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Es spielt sich folgendes ab: Die Dialogbox ist ein Pop- 
Up-Menü, welches die Kontrolle zum Programm erst nach 
ihrer Beendigung (zum Beispiel durch Drücken von OK) 
zurückgibt. Wird nun einige Zeit in der Box nichts 
angezeigt, schaltet der Zeitgeber den Bildschirm ab. Dies 
erfolgt »hinter dem Rücken« der Dialogbox (und wurde 
wohl von den Windows-Vätern nicht eingeplant). Diese 
wird nicht schwarz überzeichnet. Aber bei der 
Reaktivierung des Bildschirms ist sie verschwunden. Da sie 
jedoch noch aktiv ist, kann kein Befehl mehr im Systemenü 
von ScrSave aufgerufen werden. 

Auch beim Aufruf des Systemmenüs und Stehenlassen 
wird dieses nicht geschwärzt, sondern bleibt einsam im 
dunkeln Raum stehen, Dies ist zwar strenggenommen kor- 
rekt, sieht aber merkwürdig aus. Deshalb wird auch hier die 
Abschaltautomatik deaktiviert und beim Entfernen des 
Menüs wieder in den alten Zustand gebracht. Alles dies 
spielt sich in der Verarbeitung der Nachricht WM_MENU- 
SELECT ab. Diese Nachricht wird jedesmal gesandt, wenn 
ein Feld im Menü gewählt wird. Nicht dokumentiert ist, 
wann das Menü wieder gelöscht wird, entweder weil ein 
Eintrag gewählt wurde oder weil gedrückt bzw. die 
Maus außerhalb des Menüs positioniert wurde. Versuche 
haben ergeben, daß beim Abschalten jedesmal im oberen 
Wort des DWORD-Parameters der Nachricht 0 eingetragen 
wird. Sonst steht hier der Wert des Menü-Bezugs (Handle) 
und der ist nicht 0. Somit kann dieser Parameter als 
Identifizierung dienen. Bleibt zu hoffen, daß dies in der 
nächsten Windows-Version dokumentiert ist und nicht 
plötzlich geändert wird. 


Das Abschalten des Bildschirms 


Die Nachricht AM_SAVE erscheint, wenn der Bildschirm 
abgeschaltet werden soll. Es müssen einige Systemwerte 
gerettet werden. Hierzu zählt das Sichern des Eingabefokus, 
denn die Vergrößerung des Fensters ScrSave auf Bild- 
schirmgröße weist der Applikation den Fokus zu. Doch 
nach dem Reaktivierung des Bildschirms möchte man ja an 
der alten Stelle weiterarbeiten. 

Nach dem Sichern des Fokus wird das Fenster ver- 
größert und schwarz gezeichnet. Die Cursor-Position und 
das Cursor-Erscheinungsbild muß ebenfalls gerettet wer- 
den. Nun wird die Startposition des Cursors berechnet, der 
während der Bildschirmabschaltung am Bildschirm hin- und 
herfährt. Der Cursor wird als Sanduhr (IDC_WAIT) defi- 
niert und auf die berechnete Position gesetzt. Wenn Sie sich 
wundern, warum der Cursor mit ShowCursor noch einmal 
eingeschaltet wird, obwohl er doch schon sichtbar ist: Dies 
ıst ein Spezialfall für jene zu bemitleidenden Leute, die 
Windows ohne Maus bedienen müssen. Wenigstens in der 
Ausschaltzeit des Bildschirms bekommen sie jetzt einen 
Cursor zu sehen. 

Schließlich wird der Applikationsstatus in SetMode von 
»eingeschaltet« auf »aufgeschaltet« geändert (siehe unten). 
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Insbesondere wird der Zeitgeber so umdefiniert, daß er sich 
nicht mehr jede Minute meldet, sondern so häufig, daß die 
Sanduhr in einer kontinuierlichen Bewegung hin- und her- 
fährt. 


Das Reaktivieren des Bildschirms 


Das Gegenteil der Nachricht AM_SAVE ist AM_ACTIVATE. 
Sie wird an fwMain gesandt, wenn der Bildschirm reakti- 
viert werden soll. Diese Nachricht stammt ausschließlich 
von der Eingriffsfunktion fhEvent (siehe unten). Das 
Reaktivieren des Bildschirms ist einfach: Das Applikations- 
fenster wird wieder auf Sinnbildgröße verkleinert. Dadurch 
zeichnet sich der Bildschirm wieder auf den alten Stand. 
Der Cursor wird wieder auf die alte Position in seiner alten 
Form gesetzt und für Nicht-Maus-Benutzer wieder abge- 
schaltet. Ebenso wird der Eingabefokus dem Fenster zuge- 
wiesen, das es vor dem Bildschirm-Abschalten einnahm. Es 
hat sich also nichts geändert, außer daß der Bildschirm 
geschont wurde. 


Die Nachricht vom Zeitgeber 


Jede Nachricht von dem gesetzten Zeitgeber wird als 
WM_TIMER an die Windows-Funktion gesandt. Hier werden 
zwei unterschiedliche Aktivitäten ausgelöst, je nachdem ob 
der Bildschirm aktiv oder abgeschaltet ist: Im ersteren Fall 
wird jede Minute der Verzögerungszähler erhöht. Über- 
schreitet der Wert den eingestellten Wert (in vSave- 
Delay), so war keine Eingabe in dieser Zeit erfolgt und die 
Abschaltautomatik sendet eine AM_SAVE-Nachricht ab, die 
den Bildschirm abschaltet (siehe oben). 

Die Verarbeitung der Zeitgeber-Nachricht beim abge- 
schalteten Bildschirm ist etwas komplizierter: Hier muß das 
Cursor-Sinnbild eine Position weiterbewegt werden. Dies 
darf jedoch nur solange erfolgen, wie nicht der linke bzw. 
rechte Bildschirmrand erreicht ist. Dann muß die Bewe- 
gungsrichtung umgekehrt werden. SetCursorPos setzt die 
neue Cursor-Position. 


Beenden der Applikation 


WM_DESTROY bezeichnet bekanntlich den Wunsch, die 
Applikation zu beenden. Neben der Aktualisierung der 
WIN.INI-Datei muß hier vor allem der Systemeingriff 
entfernt werden, sonst stürzt nach dem Entfernen des 
Applikations-Codes aus dem Speicher das Windows-System 
sofort ab. 

Eine erwähnenswerte Originalität besitzt ScrSave noch: 
Sie dürfte vermutlich eine der wenigen sinnvollen Applika- 
tionen darstellen, die ohne Bearbeitung der WM_PAINT- 
Nachricht auskommen. Das Schwarz-Zeichnen des Bild- 
schirms wird durch Löschen des Fensterhintergrunds aus- 
gelöst da dieser laut Definition der Fensterklasse schwarz 
ist. 
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SetRect 
(&wrc ‚pEventCursor .x-sxCursor ‚pEventCursor.y-syCursor, 
pEventCursor .x+sxCursor ‚pEventCursor .y+syCursor 


); 
GetCursorPos(&pNewLoc) ; 
/* update cursor point */ 
memcpy((char*)&pEventCursor,, (char*)&pNewLoc,sizeof (POINT)); 
/* new mouse location within cursor rectange => 

no activation */ 

if (PtInRect(&wrc,pNewLoc)) return GL; 
I /m if %/ 
if (bSavedScreen) 
{/* Screen is saved: activate it again */ 
SPSUERRBFUBULTSENRERINLLUNTANENGR, ); 
















else 
{/* screen is active: reset delay counter */ 
vSaveTick=ß; 
y /# if %/ 

} /* fhEvent() */ 
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LONG FAR PASCAL fwMain(hw,uMsg,WP,LP) 
HWND hw; 
WORD uMsg; 
WORD WP; 
DWORD LP; 


{static HCURSOR hceukctive; /* cursor shape of active screen */ 
static POINT pActCursor; /* cursor point/active screen */ 
static POINT pSaveCursor; /* cursor point/saved screen */ 
static int vCursorDret; /* cursor direction/saved screen */ 
static hwFocus; ./* input focus before saving */ 
static bMenuSave=FALSE; /%* bSaveActive-value during menu */ 
int f; /* flag variable */ 


switch (uMsg) 
(case WM TE: 
/* set application window handle */ 
hwMain=hvw; 
















return BL; 
case WM NCCALCSIZE: 
if (bSavedScreen) 
{/* set client area to full window area */ 
return ÖL; /* no change of rectangle at <LP> */ 
I /w if %/ 
break; /* else: default activity */ 
case WM SYSCOMMAND: 
switch (WP) 
{case CMD MODE: 
if (bSaveActive) 
{/* cancel screen save mode during dialog box */ 
SetMode(FALSE,FALSE); 
I /# if ®/ 
f=DialogBox 
(hiMain,MAKEINTRESOURCE (DB MODE) ,hw,rfdMode) ; 
if (f==-1) ErrorNoMen(); 
SetMode (FALSE ,bSaveActive); 
return BL; 
case SC_RESTORE: 
case SC _MINIMIZE: 
case SC MAXIMIZE: 
case CMD TURNOFF: 
if (tbSavedScreen) 
{/* send message for saving screen */ 
SendMessage(hwMain,AM_SAVE,B,BL); 
I} Ze if %/ 
return BL; /* message consumed */ 
} /* switch %*/ 
/* other sys menu commands: default action */ 
break; 
case WM _MENUSELECT: 
/* application menu selection: stop save-screen during 
menu active %*/ 






































Windows 










if (HIWORD(LP)t=2) 
[/* Be ar 10 menu selection */ 
if (b5aveActive) 
{/* save value & cancel screen save mode #/ 
bMenuSave=-TRUE; bSaveActive=FALSE; 
SetMode (FALSE,FALSE); 
r/# if“ 












else 
{/* end of menu selection */ 
bSaveActive=bMenuSave; bMenuSave=FALSE; 
if (bSaveActive) SetMode (FALSE, TRUE); 
Y/R if %/ 
break; /* continue default action */ 
case AM SAVE: 
if (1bSaveActive) return AL; 
/* Save Screen: set black window to maximize */ 
hwFocus=GetFocus(); /* save current input focus */ 
bSavedScreen=TRUE; 
ShowWindow(hwMain,SW_SHOWMAXIMIZED) ; 
/* set saved screen cursor "hourglass”, 
save active screen cursor #*/ 
heuActive=SetCursor (LoadCursor (NULL, IDC_WAIT)); 
GetGursorPos( (LPPOINT)&pActCursor); 
pSaveCursor .x=sxCursor/2+1; 
pSaveCursor .y=3*syScreen/4; 
vCursorDret=1; /# move from left to right */ 
nemcpy ((char#)&pEventCursor, (char*)&pSavelursor, 
sizeof({POINT)); 
SsetGursorPos(pSaveCursor .x,pSavelursor.y); 
/* display cursor for non-nouse system */ 
ShowCursor (TRUE) ; 
setMode(TRUE,TRUE); /* set saved-screen mode #/ 
return BL; 
case AM ACTIVATE: 
/* activate saved screen */ 
if (bSavedScreen) 
{/* switched off and any user command: 
set screen save iconic #/ 
bSavedScreen=FALSE; /* reset flag */ 
SetMode(FALSE, TRUE); /* active screen mode #/ 
ShowWindow(hwMain, SW _SHOWMINNOACTIVE); 
/* hide cursor for non-mouse system */ 
ShowGursor (FALSE); 
/* set active screen cursor */ 
SetCursor (hcuActive); 
SetCursorPos(pActCursor .x,pActCursor.y); 
SetFocus(hwFocus); /* set active screen input focus */ 
return BL; /* no further activity */ 
I /r if ®/ 
return ÄL; 
case WM_TIMER: 
/* analyse second/minute tick */ 
if (1bSavedScreen) 
{/* minutes tick during "Screen Active Phase */ 
vSaveTick++; /* increase tick counter */ 
if (vSaveTick>=vSaveDelay) 
{/* turn off screen: Send Message to KWPMain */ 












































PostMessage(hw,AM SAVE,8,BL); 
vSaveTick=#; /* reset counter */ 
' Yfmis®/ 







else 
{/* tick during "Screen Save Phase for moving cursor */ 
pSaveCursor .x+=vCursorDrct; 
if (pSaveßursor .xisxCursor/2 || 
pSaveGursor .x>=sxScreen-sxCursor/2 








) 
{/* change direction of cursor moving */ 
vGursorDdret=-vCursorDrct; 
/* set new location in inverse direction #/ 
pSaveCursor .x+=2%*vCursorDrct; 
I /r if ®/ 
/* set new cursor location */ 
SetCursorPos (pSaveCursor .x,pSaveCursor.y); 
y /Rr if */ 
return ÖL; 
case WM DESTROY: 
case WM ENDSESSION: 
if (b5aveActivel=bWIActive) 










Aktualisierung von WIN.INI 


Beim Beenden der Applikation durch die Nachricht 
WM_DESTROY oder beim Beenden der gesamten Windows- 
Sitzung (mit der Nachricht WM_ENDSESSION) wird über- 
prüft, ob die aus WIN. INI geladenen Daten in der Dialog- 
box geändert wurden. Falls ja, werden sie mit der Funktion 
WriteProfileString aktualisiert. Falls vorher noch kein 
Eintrag Screen Save in WIN.INI stand, wird er hiermit 
angelegt. Wie in /3] wird statt sprintf die Funktion itoa 
verwendet, um die Codelänge der Applikation zu verkürzen. 


Systemeingriff mit SetWindowsHook 


Neben der Bildschirmabschaltung stellt die Erkennung der 
Eingabe-Aktivitäten in der Applikation eine Schlüsselfunk- 
tion dar, die sich nicht ohne weiteres lösen ließ. Die Ein- 
gabe-Nachrichten an die Applikation ScrSave sind wertlos, 
da normalerweise mit anderen Applikationen gearbeitet 
wird und deren Eingabe-Nachrichten nicht an ScrSave 
gesandt werden. Als Lösung kommt nur ein Systemeingriff 
(Hook) in Frage. Ein Systemeingriff ist die Definition und 
der Einbau einer Funktion, die alle Nachrichten ım Wiın- 
dows-Kern abfragt, sich die interessanten herausfiltert und 
analysiert und abschließend alle Nachrichten wieder an den 
Windows-Kern zurückgibt. Bild 9 zeigt dies beispielhaft für 
die für Scr$ave interessanten Eingabe-Nachrichten. Es gibt 
in Windows 2.03 eine Vielzahl von Eingriffen für die ver- 
schiedensten Zwecke. Sie werden mit der Funktion Set- 
WindowsHook angelegt und mit UnhookWindowsHook 
wieder entfernt. Ein Parameter beschreibt die Art des 
Systemeingriffs. 

WH_KEYBOARD ist zum Beispiel ein Wert für diesen 
Parameter. Die Eingriffsfunktion wird beı jeder gedrückten 
Taste aufgerufen. Doch die Mausbewegungen werden nicht 
erfaßt. Somit wäre dieser Eingriff nur beschränkt geeignet. 
Glücklicherweise gibt es den Eingriff WH_JOURNALRECORD, 
der für die Aufgabe hervorragend geeignet ist, obwohl er 
eigentlich für etwas völlig anderes dient: In manchen Appli- 
kationen (zum Beispiel Tabellenkalkulationen) müssen 
immer wieder dieselben Tastendrücke und Mausbewegun- 
gen durchgeführt werden, um eine bestimmte Aktion aus- 
zuführen. Die Arbeit kann dadurch erleichtert werden, daß 
einmalig alle Mausbewegungen und Tastendrücke bei der 
Ausführung der Aktion aufgezeichnet und in eine Art 
Makro gespeichert werden. Bei einem erneuten Ablauf der 
Aktion wird dann einfach statt den Bewegungen und 
Tastendrücken das Makro gestartet, welches die Eingabe 
selbständig sımuliert. Zur Aufzeichnung der Bewegungen 
und Tastendrücke ist WH_JOURNALRECORD gedacht, zum 
erneuten Ablaufen WH_JOURNALPLAYBACK. Für Scr$ave 
wird also WH_JOURNALRECORD zweckentfremdet, dies stört 
jedoch die Funktionsweise des Eingriffs in keinerlei Weise. 
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Setzen des Applikations-Zustands in SetMode 


In der Funktion SetMode wird die automatische Bild- 
schirmabschaltung und die Bildschirmabschaltung jeweils 
ein- und ausgeschaltet. Zwei Aktionen sind damit verbun- 
den: Defininieren/Entfernen eines Systemeingriffs und 
Starten/Stoppen eines Zeitgebers mit der geeigneten Zeit. 

Mit SetWindowsHook wird die Eingriffsfunktion fh- 
Event in das Windows-System eingefügt. Ab sofort werden 
alle Eingabe-Nachrichten an diese Funktion gesandt. 

Hier geht es wieder leicht experimentell zu, jedenfalls 
sieht die Funktion leicht anders aus als im Windows-Refe- 
rence-Manual beschrieben. Der dritte Parameter sollte laut 
diesem Handbuch auf eine Nachrichten-Struktur (MSG) zei- 


{/* store modified flag into WIN.INI */ 
ME 
("Screen Save”, "Save" bSaveActive? "Yes":"No”); 
r/# if“ 
if (vSaveDelay!=vWlIDelay) 
{char zBuf[ 18]; 
/* store modified value into WIN.INI */ 
WKriteProfileStrin 
("Screen Save”, "Delay”, 
‚UPSTR)Itoa(vSaveDelay, zBuf, 18) 


} j} if #/ 
/* destroy timers & event hook #/ 
bSaveActive=FALSE; SetMode(FALSE,FALSE); 
if (uNsg==WM DESTROY) 
{/* terminate application */ 
PARIS ENBERAGELD): return ÖL; 
#* 


| break; 
} /* switch #/ 
return DefWindowProc(hw,uMsg,WP,LP); 
} /* fwMaint) %/ 


gen, dies war jedoch definitiv nicht der Fall. Sie zeigt viel- 
mehr auf einen einsamen Nachrichten-Wert ohne Parame- 
ter oder Zielfenster-Bezug. Ob sich hier die Handbuch- 
autoren oder die Implementierer geirrt haben, bleibt 
unklar. Laut Reference-Manual sollte die Funktion über- 
haupt keinen Wert (void) zurückliefern, dies kollidiert 
jedoch mit der Vereinbarung der Funktion DefHookProc, 
die einen DWORD-Wert zurückliefern muß, wenn nicht das 
gesamte Windows-System abstürzen soll. Das Reference- 
Manual muß hier vermutlich wie folgt interpretiert werden: 
Grundsätzlich liefert jede Eingriffsfunktion (Hook-Func- 
tion) einen DWORD-Wert zurück. Oft (und so bei WH_JOUR- 
NALRECORD), wird dieser Wert jedoch nur von DefHook- 
Proc verwendet. 


EM 
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LoadWininiData 
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\Load all values from the file WIN.INI into the data areas which 
are needed by the er 

This function is called only by the first instance of a window. 
Later instances copy the data from the first instance by the 
API function GetInstanceData() in the function PreviousData(). 


Wie arbeitet nun die Eingriffsfunktion fhEvent? Wenn ERTORENEEN 
der Parameter vCode negativ ist, muß entsprechend der | 
Return: 


Regeln des Reference-Manuals DefHookProc aufgerufen 11 ie any:erroroenures: dirineirending KEN INT File, 
werden und ihr Rückgabewert zurückgegeben werden. DB if read correctly but no valid changes nade, 
Diese Funktion wird zum Beispiel dann aufgerufen, wenn I BEER ESTERERAT RUE TRIER DANEER MRS 

die Liste der Eingriffsfunktionen umgebaut wird. Deshalb 
besitzt sie auch einen Zeiger auf die Adresse der Nach- 
folger-Eingriffsfunktion (in rfhPrefEvent). Ist vCode 


a | 


int LoadkinIniData() 


nicht negativ, erfolgt die eigentliche Verarbeitung der Nas, 
Eingabe-Nachricht. int S; 
Handelt es sich hierbei um keine entscheidende Eingabe | +-#; 


/* Get delay value (in minutes) */ 
v=GetProfilelnt("screen save" "delay",5); 
fi=vSaveDelayt=v; vWIDelay=vSaveDelay=v; 
GetProfileString("screen save”, "save", "YES", s sizeof(s)); | 
/* result: start with 'Y’ => TRUE, otherwise => FALSE #/ 
v=strlen(s)>d && KORB PAS UDBET BARS ENTRESDNGERSLEN 7374 | 
| £l=bSaveActivel=v; bWIActive=-bSaveActive=v; 
| return f; /* 8 or 1, no error possible */ 
} /* LoadWinInibatat() * 


| ra EEE 


InitWindow 
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wie Taste heruntergedrückt oder Maus bewegt, spielt diese 
Nachricht für ScrSave keine Rolle, und die Eingriffsfunktion 
wird beendet. Sonst muß zwischen Tastendruck und reiner 
Mausbewegung unterschieden werden. Bei einem Tasten- 
druck (Tastatur oder Maus) wird der Bildschirm immer 
reaktiviert. Bei einer Mausbewegung dagegen genügt es 
nicht, WA_MOUSEMOVE allein zur Reaktivierung zu verwen- 
den. Der Grund liegt darin, daß WM_MOUSEMOVE nach be- 
stimmten Systemaufrufen vom Windows-System gesendet 


wird, auch wenn die Maus physikalisch gar nicht bewegt The application window is initialized. This function is called 


; 5 B ? , only once. The created data are used for all instances of the 
wurde. Nachdem dies durch eine ziemlich aufwendige und |windov. 
undurchsichtige Flag-Verwaltung eliminiert worden war, [parameters: 


trat ein anderes Problem auf: die Empfindlichkeit der hifain is the handle to the (first) instance. 


Maus. Man brauchte nur mit der Hand auf den Tisch zu 
klopfen oder laut zu husten und schon hat eine empfind- 
liche Logitech-Maus den Bildschirm wieder eingeschaltet! 


Return: 


TRUE is returned if initialization correct, otherwise FALSE 
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Weltweit gibt es immer mehr Tallyaner. 
Kein Wunder. Denn bei der Breite 
unseres Programms bieten wir jedem 
den richtigen Drucker. Zum Ein- 
steigen, Aufsteigen und Umsteigen. 
Passend zu fast jedem System. 

Wir bauen Drucker, die von sich reden 
machen, weil man so wenig dB (A) 
von ihnen hört, und solche, mit 

denen man es bunt treiben kann - 

in 12 Farben. 

siehabendieWahl zwischen Druckern, 
die besonders schön, besonders 
schnell und besonders schnell schön 
drucken. Und wenn Sie häufig die zu 
verarbeitenden Papiere wechseln 
müssen - wir bauen sogar Drucker, 
die sich vollautomatisch umstellen. 
Um nur einige Vorteile zu nennen. 


Werden Sie doch auch Tallyaner. 
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Mannesmann Tally GmbH 
Postfach 2969, D-7900 Ulm 
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und Ihre Typenubersicht über Nadel-, Tinten- | 
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BOOL InitWindowt ) 
{WNDCLASS WndClass; 


/* create window class */ 
WndClass.1pszClassName=zAppNane; 
WndClass-hinstance=hilain: 
KndClass.1pfnWndProc=fwHain; 
WndClass.hCursor=NULL; 
WndClass.hbrBackground=GetStockübject(BLACK_BRUSH); 
WndClass.style=ß; 
WndClass.hIcon=LoadIcon(hiMain, zAppName) ; 
WndClass.1pszMenuName=NULL; 
WndClass.cbClsExtra=#; WndClass.cbWndExtra=P; 
/* register window, return if error */ 

if (tRegisterClass(&WndClass)) return FALSE; 


/* Load data from WIN.INI */ 
LoadkinIniData(); 


/* Get System Parameters */ 

sxScreen=GetSystemMetrics(SM CXSCREEN); 
syScreen=GetSystemMetrics(SM CYSCREEN); 
sxCursor=GetSystemMetrics (SM _CXCURSOR) ; 
syCursor=GetSystenletrics (SM_CYCURSOR) ; 


/* return without error */ 
return TRUE; 
} /* Initkindow() */ 


eusssssRRRREEHREHHHHHEEIEIHHHEIEHHEHIHIHHHIEIHIHIEIHIHIHIHIEIHHHEHEDE IE DEE 
InitInstance 
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The complete initialization of a new instance of the 
application window. If no previous instance exists, the 
‚application window is initialized and the common data for all 
'instances are created. Otherwise, common data are copied from 
the previous instance to the new instance. 

All individual data in the instance data segment are 
'initialized. 

‚If memory is too small, a error message box is displayed and 
FALSE is returned. 


Parameters: 

hiPrev is a handle to the first instance of the window. 
| hiNew is a handle to the new instance of the window. 
zCmdLine points to the command line buffer. 

vCmadShow is the entry style of the window. 


Return: 
TRUE is returned if initialization complete, 
otherwise FALSE (memory too small). 


BE EEE 6 202 En 2 2 2 202 202 202 002 205 2000200 20805 202 0202 202 200 200 050002020508 020202 2020203 KERN / 


BOOL InitInstance (hiNew,hiPrev, zCmdLine , vEndShow) 
HANDLE hiNew,hiPrev; 
LPSTR zCmdLine; 
int vCmdShow; 


{char zBuf[8#]; 
HMENU hansysten; 
int v; 


hiMain=shiNew; /* set instance Be! #f 


LoadString(hiMain,STTITLE,zApp 
if (thiPrev) 
{/* Initialize window, exit if error */ 
(HInitWindow(}) goto MenError; 


itle,sizeof(zAppTitle)); 


else 
[/%* AplieaHlor will be called only once %/ 
LoadString(hiMain,ST2NDINST, zBuf,sizeof(zBuf)); 
MessageBox (NULL, zBuf,zAppTitle,MB_ICONASTERISKIMB_OK); 
an DE /* return with error *%/ 
# # 
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Um dieses Problem zu lösen, wird deshalb in ScrSave 
geprüft, ob die Maus tatsächlich bewegt wurde. Dies wird 
dadurch festgestellt, indem die Position bei WM_MOUSEMOVE 
mit der zuletzt gesetzten verglichen wird. Liegt die neue 
Position außerhalb eines Feldes um die alte, das der 
doppelten Größe des Cursor-Sinnbildes entspricht, wird 
angenommen, daß die Maus tatsächlich bewegt wurde und 
die Eingabeaktion ist gültig. Andernfalls wird die 
Mausbewegung ignoriert. Durch diesen Trick wurde auch 
erreicht, daß die Maus vom Tisch angehoben und wieder an 
anderer Stelle abgelegt werden, ohne daß sich der Bild- 
schirm wieder einschaltet. Auch konnte die oben erwähnte 
aufwendige Flag-Verwaltung wieder entfernt werden (Ich 
habe fünf Stunden gebraucht bis diese einwandfrei lief...). 

Liegt eine gültige Eingabe-Nachricht vor und ist der 
Bildschirm gerade abgeschaltet (bSavedScreen ıst TRUE), 
wird eine AM_ACTIVATE-Nachricht an fhMain gesandt. 
Die weitere Verarbeitung der AM_ACTIVATE-Nachricht 
wurde bereits oben beschrieben. Ist der Bildschirm aktıv, 
setzt jede Eingabe-Nachricht in fhEvent den Zähler, der 
die verstrichene Zeit bis zum Bildschirm-Abschaltzeitpunkt 
hochzählt, auf Null zurück. Somit wird das Abschalten bei 
jeder Eingabe erneut verzögert. 


Besonderheiten beim Arbeiten mit 
Systemeingriffen 

Das Programmieren mit Systemeingriffen verlangt einige 
tiefgehendere Kenntnisse des Windows-Systems. So hat das 
SS-Register innerhalb einer Eingriffsfunktion einen anderen 
Wert als das DS-Register. Somit muß die Windows-Applıi- 
kation unbedingt mit der Compiler-Option -Aw übersetzt 
werden, damit der Compiler weiß, daß er DS und SS nicht 
einfach als synonym annehmen kann. Daß diese Annahme 
hierbei außerhalb der Eingriffsfunktion zu Compiler- 
Warnungen »SS!=DS« beim Aufruf der Zeichenketten- 
Bibliothek führt, kann ignoriert werden, da dort SS=DS 
vom Betriebssystem garantiert ist. 

Vielleicht ist Ihnen schon aufgefallen, daß in SCR- 
SAVE.DEF (Bild 5) das Code- und Data-Segment nicht 
MOVEABLE oder DISCARDABLE ıst, sondern als FIXED ver- 
einbart worden ist, also weder im Speicher verschoben noch 
während seiner Ausführung aus dem Speicher entfernt wer- 
den kann. Dies ist erforderlich, weil WH_JOURNALRECORD 
einen Kerneingriff von Windows darstellt (im Gegensatz zu 
WH_MSGFILTER) und der Code der Eingriffsfunktion stän- 
dig verfügbar sein muß. Ist der Code nun nicht fixed, kann 
er in einer EMS-(expanded memory system)-Umgebung in 
eine Speicherbank ausgelagert werden, die vom Kern aus 
nicht zugreifbar ist. Dies führt früher oder später zu einem 
Systemabsturz. In [1] wird deshalb empfohlen, den Code 
und die Daten der Eingriffsfunktion und damit die der gan- 
zen Applikation als fixed zu vereinbaren. Er wird dann 
von der Speicherverwaltung nicht in den expanded memory 
ausgelagert. Im Gegensatz hierzu empfiehlt das Windows- 


Reference-Manual, die Funktion in eine dynamische Link- 
Library zu verlegen, eine kompliziertere aber vielleicht effi- 
zientere Methode. 


Setzen der Zeitgeber 


In SetMode wird auch der Zeitgeber für die Ermittelung 
der Abschaltverzögerung und für die Bewegung des Sand- 
uhr-Cursors während der Ausschaltphase gesetzt und 
gelöscht. Auf Zeitgeber wird in /3] detailliert eingegangen, 
so daß sich der Autor hier kurz fassen möchte, Der Zeit- 
geber für die Abschaltverzögerung meldet sich etwa jede 
Minute, so daß er kaum das System belastet. Während der 
Ausschaltphase wird er so umdefiniert, daß er den Takt für 
die Cursorbewegung vorgibt. Es wird ein Wert verwendet, 
bei dem das Sinnbild des Cursors innerhalb einer Sekunde 
seine Breite als Weg zurücklegt. Der Zeitgeber ist in diesem 
Fall schr aktıv. 

Bekanntlich ist der Zeitgeber nicht sonderlich genau. Da 
jedoch kaum jemand seine Uhr nach der Ausschaltverzöge- 
rung des Bildschirms stellen wird, ist dies hier nicht sonder- 
lich wichtig. 


Ausblick 


Wie man sieht, kann man unter Windows auch unkonven- 
tionelle Probleme elegant lösen, obwohl es hier oder da 
noch ein wenig »klemmt«. Die Universalität von MS-Win- 
dows ıst dem Weitblick der Windows-Designer bei 
Microsoft zu verdanken. Gleichzeitig wird auch der weit- 
verbreitete Irrglaube widerlegt, Programmieren unter Win- 
dows würde wegen der Gleichartigkeit von Ein- und Aus- 
gabe zu einer langweiligen und unkreativen Arbeit führen. 
Das Gegenteil ist der Fall, allerdings auf einem höheren 
Niveau: Der Programmierer wird seine Erfahrung und 
Kreativität nicht mehr in Ein-/Ausgabetreiber stecken, 
deren Entwicklung zeitraubend und frustrierend ist, son- 
dern kann sich voll auf die mit seiner Applikation zu reali- 
sierenden Algorithmen konzentrieren, wobei er geschickt 
unter einer Vielzahl von Hilfsmittel (Windows-Funktionen 
und -Nachrichten) auswählen muß, um die Realisierung 
möglichst elegant erscheinen zu lassen. Was bietet mehr 
Abwechselung und Kreativität? Bleibt abschließend noch zu 
hoffen, daß die Applikation ScrSave ohne große neue 
Klimmzüge auch unter dem OS/2-Presentation-Manager 
läuft. 

Marcellus Buchheit 


Marcellus Buchheit ist Geschäftsführer der Buchheit soft- 
ware research, einem Unternehmen, das sich auf die Ent- 
wicklung von Anwendungen unter Microsoft Windows (und in 
Zukunft auch dem OS/2-Presentation Manager) spezialisiert 









/* Create procedure instance addresses */ 
rfdMode=NakeProcInstance(fdMode,hiMain); | 
rfhEvent=MakeProcInstance( (FARPROC) fhEvent ‚hiMain); 


/* Create Application's Window, branch if error */ 
if (!CreateWindow 
SEE cu ken QVERLAPPEDWINDON, 
SEDEFAULT,CW USEDEFAULT,CH USEDEFAULT, 
Ks _USEDEFAULT NULL ‚NULL, hilain, „NULL 









) 
goto MenError; 







/* Change system menu */ 
hanSystem=GetSystemMenu(hwMain, FALSE); 
ChangeMenu(hanSystem,®,NULL,®, MF _APPENDIMF _SEPARATOR); 
az tring(hiMain,STTURNOFF, zBuf, ‚sizeof(zBuf)); 

Beer amSyalen, 8, zBuf ,CMD TURNOFF ‚MF APPENDIMF STRING); 
Load tring(hiMain, STMODE, zBuf,sTzeof(zBuf)); 
ChangeMenu(hanSysten, B,zBuf, CMD | MODE ‚MF _APPEND|MF _STRING); 









/* Show application always as icon #/ 
Showkindow(hwiain, SW_SHOWMINNOACTIVE); 


/* Display mode dialog box if non-iconic show mode */ 
if (vCmdShowt=SW 5 INNOACTIVE) 
{v=DialogBox(hiMain, MAKEINTRESOURCE(DB_MODE), hufain, 
rfdMode); 










if (v==-1) ErrorNoMen(); 

ia if®/ 
SetMode(FALSE,b5SaveActive); /* define active-screen node */ 
/* return without error %*/ 
return TRUE; 











MenError: 
‚ErrorNoMen(); return FALSE; /* return with error */ 
} /* InitInstance() */ 
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WORD pascal WinMain(hiNew,hiPrev, zCndLine , vCmdShow) 
HANDLE hiNew,hiPrev; 
LPSTR zCndLine; 
int vCadShow; 


{MSG wm; 







/* Initialize (window and) instance, return if error */ 
if (!InitInstance(hiNew,hiPrev, zCmdLine. ‚vCmdShow) ) 
return FALSE; 

Fe application execution loop --- */ 

A (GetMessage (&wm,NULL,8,8)) 

{TranslateMessage(&wn) ; DispatchMessage(&m) ; 

} /* while %/ 
return wa.wParan; 
} /* WinMain() */ 










End of WINDOKS Application SCRSAVE 










#/ 


Bild 3: Das C-Programm der Applikation SCRSAVE.C 


hat. Buchheit software research berät auch Firmen, wie unter 
Windows programmiert wird und welche neue Perspektiven 
ein solches System dem Programmierer bietet. Außerdem 
entwickelt die Firma im Auftrag Software für Windows. 
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include <WINDOWS.H> 
|#include "DEFS.H” 


SCRSAVE ICON SCRSAVE.ICO 
STRINGTABLE BEGIN 

STTITLE, "Bildschirm aus” 

STMODE, "&Einstellungen..." 

STTURNOFF ‚"Bildschirm &aus” 

STERROR, 

"Zu weni 5 eicherplatz. Bitte beenden Sie eine Applikation.” 
STTIMEOVL,"Zu viele Zeitgeber gestartet." 

ST2NDINST, F CENT bereits gestartet." 
END /* STRING 


IDBE MODE DIALOG LOADONCALL MOVEABLE DISCARDABLE 8,-76,112,76 
CAPTION "Bildschirm aus" 
an WS_BORDER ıWS_CAPTION:WS_DLGFRAME WS POPUP 
CONTROL "r 1988, Marcellus Buchheit”, IDNONE "static", 
SS LEFTIWS CHILD,4,4,184,8 
CONTROL "&Äktiv”, IDACTIVE, "button", 
BS AUTOCHECKBOXIWS_ TABSTOPINS_ GROUP |WS_CHILD, 
4,28,32,12 
CONTROL "gVerz+ erung:", IDNONE, "static", 
SS _LEFTIWS ILD, 4, 48,48, B 
CONTROL "", ‚IDDELAY, "edit", 
ES "LEFTINS BORDER|WS_ TABSTOP |WS_ GROUP | HS_CHILD, 
56,38,16,12 
CONTROL "nin” " IDNONE, "static", 
ss LEFTINS CHILD, 74, 48, 12,8 
CONTROL "&ÖK” ,IDOK, "button’ 
BS DEFPUSIBUTTON INS. "TABSTOP INS _ GROUP IWS_CHILD, 
CONTROL "&Beenden”, IDEXIT, "button", 
BS PUSHBUTTON!NS _TABSTOPIWS_ CHILD, 72,58,36,14 
END /#* DB_ MÖDE #/ 


Bild 4: Die Resource-Datei SCRSAVE.RC 


NAME SCRSAVE 

DESCRIPTION '’Screen Save Application - 1.08' 
STUB '"WINSTUB.EXE' 

CODE FIXED 

DATA FIXED 


HEAPSIZE 512 


STACKSIZE 4896 


EXPORTS 
fwMain @1 
fdMode 82 
fhEvent #3 


Bild 5: Die Linker-Definitionsdatei SCRSAVE.DEF 
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SCRSAVE.RES: SCRSAVE.RC DEFS.H SCRSAVE.ICO 
RC -r SCRSAVE.RC 


|SCRSAVE.OBJ: SCRSAVE.C DEFS.H 
CL >SCRSAVE.ERR -c -Answ -Gsw -Os -Zdp SCRSAVE.C 


SCRSAVE.EXE: SCRSAVE.OBJ SCRSAVE.RES SCRSAVE.DEF 
LINK4 /A:16/M/LI SCRSAVE, , ‚SLIBW,SCRSAVE 

MAPSYM SCRSAVE 

RC SCRSAVE.RES 





Bild 6: Die Make-Datei SCRSAVE 


Fi eialoe box resources */ 
define DB MODE 


1/* menu commands */ 

280 
| n 281 
“define CHD ABOUT 202 


/* strings #/ 

#define STTITLE 

#define STERROR 

#define ST2NDINST 1882 
#define STMODE 

#define STTURNOFF 1884 
define STTIMEOVL 1885 


/# alge box entries */ 
/define IDNONE 

Zdefine IDACTIVE 2088 
define IDDELAY 

#define IDEXIT 


Bild 7: Die Header-Datei DEFS.H 


Icon Editor - SCRSAVUE.ICO 


File Edir Options eier ensier 


editing..: Hi-res &64x64 | 
viewing..: Hed-res 32x32 


Bild 8: SCRSAVE. ICO nach dem Laden in ICONEDIT 


Nachrichtenverarbeitung 
(Hook function) |4-F Applikation 


JüöorrrbirH ko d 


|Nachrichten- 
ETZEUGUNE Ken es „Eingritt Nachrichtensamnlung 
ok) MS-Windows 


MEOASTFrTE 


"Eingabe" - 
— normaler Keg 


Tastatur- Maus 
dekoder dekoder 
: J 


Tastatur 


IPB ERAHPRT 


Bild 9: Windows-Kern-Eingriff (Windows-Hook) für die Ein- 
gabe-Nachrichten 
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in einem Buch: 
AUESRERSIC 
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Dieses einzigartige Info-Paket hätten wir ebenso treffend die DOS-Bi- 
bel nennen können: Hier finden Sie gebündelt alles, was man wissen 
muß, um MS-/PC-DOS bis Version 3.3 sicher einzusetzen und voll aus- 
zureizen. Vom einfachen Anzeigen eines Inhaltsverzeichnisses bis hin 
zur kompletten Stapeldatei-Programmierung bietet der Autor eine 
Knowhow-Fülle, die ihresgleichen sucht: Installation, Konfiguration des 
Systems und einfache Befehle sind zum Beispiel Themen, die für einen 
sicheren Start sorgen; Meta-Zeichen, der Editor EDLIN, die Program- 
mierung einer Stapeldatei und vieles mehr werden in den Kapiteln für 
die fortgeschrittene DOS-Programmierung behandelt; auf die Samm- 
lung von Tools und Utilities sowie die komplette Befehlsübersicht wer- 
den selbst professionelle Programmierer immer wieder mit großem 
Nutzen zurückgreifen. 


Jetzt überall, wo es gute Computerbücher und Software gibt. 
Fordern Sie unser Gesamtverzeichnis an! 








Windows 


Dial anz nebenbei: 


Dynamische Dialogboxen unter Windows 


Dialogboxen oder Eingabemasken dynamisch, so 
ganz »nebenbei«, zu erzeugen, war unter Win- 
dows 1.x nicht möglich. Der einzige Weg, eine 
Eingabemaske oder Dialogbox zu definieren, be- 
stand in der Ressourcendatei. Microsoft Win- 
dows 2.x enthält nun jedoch zwei neue Funktio- 
nen, mit denen Programmierer dynamisch sol- 
che Dialogboxen erzeugen können, wie sie in den 
Beispielmakros von Microsoft Excel zu sehen 
sind. 


DialogBoxIndirect und CreateDialogIndirect 


Die beiden neuen Funktionen von Windows 2.0, dıe hıer 
gemeint sind, heißen DialogBoxIndirect und Create- 
DialogIndirect. Eine genaue Untersuchung zeigt, daß 
der einzige Unterschied zwischen den Standardfunktionen 
DialogBox/CreateDialog und den Funktionen Dia- 
logBoxIndirect/CreateDialogIndirect darın be- 
steht, daß letztere anstelle eines Long-Pointers eine Handle 
als zweiten Parameter verwenden. Wenn man diese Routi- 
nen in einer Anwendung einsetzt, hat das Programm oder 
der Benutzer die Möglichkeit, Dialogboxen nach Wunsch 
anzulegen oder zu verändern. 

Eine Dialogbox mit ungefähr 20 verschiedenen Feldern 
oder Steuerungen ist in Bild 1 zu sehen. Das ungewöhnliche 
an dieser Dialogbox ist, daß sie dynamisch durch den Auf- 
ruf von DialogBoxIndirect oder CreateDialog- 
Indirect angelegt wurde und keine Zeilen in der Res- 
sourcendatei oder einen Aufruf der Funktion CreateWin- 
dow erforderte. Eine Tabelle für die Funktionen Dialog- 
BoxIndirect oder CreateDialogIndirect ist die ein- 
zige Voraussetzung. 


Die Dialoge von Microsoft Excel 


Eine der vielen leistungsfähigen Möglichkeiten von 
Microsoft Excel ist, daß der Benutzer eigene Dialogboxen 
definieren kann. Das erfolgt so, daß man eine Tabelle der 
gewünschten Steuerungen in einem Makroblatt definiert 
und diese Tabelle aufruft. Der gleiche Tabellentyp wird in 
Windows-Anwendungen benötigt; diese Tabelle kann je- 
doch jede beliebige Form und jedes beliebige Aussehen 
haben, die Sie für Ihre Anwendung wünschen. Sie kann eine 
Textdatei sein, die in das Programm eingelesen oder direkt 
eingebaut wird oder auch eine Parameterliste, die dadurch 
angelegt wird, daß der Benutzer Werte in eine Eingabe- 
maske eingibt. Ganz gleich, wie die Tabelle aussieht, Ihr 
Programm kann dann Dialogboxen dynamisch anlegen und 
verändern. 
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Bild 1: Die dynamische Dialogbox von DLGBOX,. 


Das Programm DigBox 


Das Programm DlgBox besteht aus zwei Modulen, DLG- 
BOX.C und DLGTEMP..C. DigBox ist der Hauptteil des Pro- 
gramms, von dem aus ein Aufruf des Moduls DIgTemp für 
jedes Dialogfeld erfolgt, daß sich in einer Dialogbox befin- 
den soll. DIgTemp baut diese Felder in eine Tabelle ein, die 
später wieder an das Programm DigBox zurückgegeben 
wird. Das Modul DlgTemp wurde als separate Einheit kon- 
zipiert, damit Sie es in Ihre Anwendung integrieren können. 
Wir wollen uns nun die verschiedenen Teile des Programms 
ansehen. Die Make-Datei (Listing I) enthält alle Befehle, 
die notwendig sind, um diese Anwendung zu erstellen. 
Denken Sie daran, daß zwei Funktionen nur in Windows 2.0 
und neueren Versionen verfügbar sind, Sie müssen also das 
Microsoft Windows Software Development Kit Version 2.x 
und den Microsoft C 5.0 Compiler oder eine neuere 
Version verwenden. 

Die Ressourcendatei, die in Listing 2 zu sehen ist, ent- 
hält das Sinnbild und zweı Menüs. Mit dem ersten Menü 
können Sie auswählen, ob die erzeugte Dialogbox modal 
oder moduslos ist. Der Unterschied wird später noch 
erklärt. Das zweite Menü wird in der dynamischen Dialog- 
box als Beispiel dafür verwendet, wie man es zu einem Teil 
der Dialogbox machen kann. 


Neue Datenstrukturen 


Bei der Verwendung von DialogBoxIndirect und Cre- 
ateDialogIndirect werden für den Aufbau einer Dia- 
logbox nur zwei Strukturen benötigt. Die erste ist die 
Struktur DialogHeader (Listing 4). Sie wird als Header 
der zu erstellenden Tabelle verwendet. Die zweite Daten- 
struktur ist DialogItem (Listing 4). Die Struktur Dialog- 
Item wird für jede Steuerung verwendet, die in der Dialog- 
box plaziert wird. 
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Windows 


Idlgtemp.obj: dlgtemp.c digbox.h 
98% e‘ SE En, -Gsw -Os -Zpe dlgtemp.c 


d1grox. DB: dlgbox.c dlgbox.h 
cl -d -ce -W2 -AS -Gsw -Os -Zpe dlgbox.c 


dlgbox.res: IESOR.Ee dlgbox.h 
re -r dlgbox.rc 


dlgbox.exe: 
link4 digbox dligtenp, 


rc dlgbox.res 


dlebox.ob] dlgbox.def dlebox.res dlgtenp.obj 
Glgdox/al:18,digbox, 
slibw slibcew /noe,dlgbox.def 


Zinclude <style.h> 
Zinclude "dlgbox.h” 


MENUITEM "&Modal”, IDM_MODAL 
MENUITEM "M&odeless”, IDM MODELESS 
END 


dlgtemp MENU 
BEGIN 
POPUP "&Top Menu” 
BEGIN 
MENUITEM "&0ne"”, IDM_ONE 
END 


| END 


Listing 2: Die Ressourcen-Datei für DigBox. 


D1gbox 
'WINSTUB.EXE' 


CODE 
DATA 


MOVEABLE 
MOVEABLE MULTIPLE 


HEAPSIZEE 4896 
STACKSIZE 4896 


EXPORTS 
D1gboxWndProc @1 
DialogBoxWindowroc 82 


Listing 3: Die Moduldefinitionsdatei für DigBox. 


Nur drei Funktionen brauchen im Modul DlgTemp auf- 
gerufen werden, um die ganze Arbeit für die Anlage der 
Dialogstruktur im globalen Speicherbereich durchzuführen. 
Dies sind die Funktionen CreateDialogHeader, Cre- 
ateDialogItem und EndDialogHeader. 
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CreateDialogHeader 


Die Funktion CreateDialogHeader übergibt Parameter 
zum Auffüllen der verschiedenen Teile der Struktur Dia- 
logHeader, wie das in Listing 5 zu sehen ist. Wenn die 
Struktur fertig aufgebaut ist, wird ein wenig globaler Spei- 
cher allokiert, um die DialogHeader-Informationen für 
die spätere Verwendung zu speichern. 

Wenn Sie sich die Struktur DialogHeader ansehen, 
sehen Sie, daß sie aus den meisten Parametern besteht, die 
für die Struktur CREATESTRUCT von CreateWindows 
benötigt werden. Und genau dafür wird sie auch später, 
wenn die Felder ausgefüllt sind, eingesetzt. Das Feld 
dtItemCount ist das einzige neue. Es definert die Anzahl 
der Felder oder Steuerungen in der Dialogbox. Dieses Feld 
kann jedoch erst ausgefüllt werden, wenn die Anzahl der 
Felder bekannt ist. Das erste Feld, dtStyle, enthält dıe 
Fensterstilattribute für die Dialogbox bzw. CreateWindow 
(s. Tabelle 3.4 im Microsoft Windows Software Develop- 
ment Kit Programmer’s Reference Version 2.x). 


Die Felder dtX und dtY werden dazu verwendet, um 
die obere linke Ecke der Dialogbox im Zeichenbereich des 
übergeordneten Fensters zu positionieren. Die Felder dtCX 
und dtCY werden dann verwendet, um die Breite und Höhe 
der Dialogbox zu definieren. Um festzustellen, wie breit die 
Dialogbox sein sollte, multiplizieren Sie die Anzahl Zeichen 
mit 4 und addieren etwa 10 hinzu, um einen Rand auf bei- 
den Seiten zu erhalten. Für die Höhe multiplizieren Sie die 
Anzahl Zeilen mit 8 und addieren auch wieder 10 für den 
Rand darauf. Der Einfachheit halber können auch die 
Breite und Höhe vom Dialog-Editor DIALOG.EXE direkt 
und ohne Umwandlung verwendet werden. 

Der folgende Teil der Struktur besteht aus drei Feldern 
mit variabler Länge. Sie werden variabel genannt, da die 
Größe des Feldes zwischen 1 und vielen Byte schwanken 
kann. Da wir nicht im voraus wissen, wie lang diese Felder 
sein werden, können wir keinen Speicherbereich dafür zu- 
weisen. Wir könnten Sie so lang wie möglich definieren, 
doch dadurch wird unnötig Platz verschwendet. Bei der 
Verwendung dieser Felder wird eine einfache Regel befolgt: 
Wenn eines nicht gebraucht wird, ist das erste Byte 0. 

Im ersten Byte nach der Struktur DialogHeader folgt 
der Ressourcen-Name, dtResourceName, der den Namen 
der Menü-Ressource in der Ressourcendatei der Anwen- 
dung definiert. Wenn das erste Byte 0 ist, wird bei dieser 
Dialogbox kein Menü verwendet. Wenn Sie die Nummer 
der Menü-Ressource verwenden wollen, muß das erste Byte 
FFh sein und darauf in drei Byte die Zahl (in ASCIIT) fol- 
gen. Wenn das erste Byte nicht 0 oder FFh ist, wird ein mit 
0 abgeschlossener String erwartet. 

Das Feld dtClassName definiert die Fensterklasse der 
Dialogbox. Wenn das erste Byte 0 ist, wird die Standard- 
klasse DialogClass verwendet. Wenn Sie Ihre eigene 
Fensterklasse definieren wollen, übergeben Sie einen mit 0 


Windows 





abgeschlossenen String in dtClassName. Dies ist der glei- 
che Wert, der im Feld 1pWindowName der Funktion 
CreateWindow verwendet wird. 

Nun da wir mit dem Füllen der Struktur Dialog- 
Header fertig sind, haben wir alle Felder für den Aufruf 
der Funktion CreateWindow beisammen. In unserem Bei- 
spiel haben wir das vereinfacht, indem wir die Parameter 
der Funktion CreateDialogHeader übergeben haben. 
Wir können nun die einzelnen Felder angeben, die in der 
Dialogbox angezeigt werden sollen. 


CreateDialogltem 


Die nächste Funktion ın unserem. Programm ist Create- 
DialogItem. Mit ıhr werden alle Informationen über- 
geben, die notwendig sind, um die verschiedenen Teile der 
Struktur DialogItem aufzufüllen. Nachdem die Struktur 
gefüllt ist, wird der globale Speicherblock mit der Funktion 
GlobalRealloc auf die benötigte Größe erweitert. Dann 
werden die Informationen in den erweiteren Speicherblock 
kopiert. 

Ein Vorteil der Funktion CreateDialogItenm ist, daß 
die meisten Fenstersteuerungen und ihre Stile bereits vor- 
definiert sind, so daß man sie mit einer Zahl ansprechen 
kann. Dies erspart es einem, all die verschiedenen Attribute 
für eine vordefinierte Steuerung übergeben zu müssen, wie 
in Microsoft Excel. 

Die Struktur DialogItem besteht aus den gleichen 
Feldern, wie die Struktur DialogHeader, denn diese 
Werte werden benötigt, um die Funktion CreateWindow 
aufzurufen. Die Felder dtilX, dtilY, dtilCX, dtilCY 
definieren die obere linke Ecke und die Breite/Höhe der 
Steuerung. Das Feld dtilID ist die Steuerungs-IDs (z.B. 
IDOK). Dieser Wert ist der gleiche, wie er für das Feld 
hMenu der Funktion CreateWindow verwendet wird. 

Das Verhalten der Steuerung wird mit dem Feld dtil- 
Style definiert, Es kann jeder der vordefinierten Win- 
dows-Stile sein und entspricht dem Wert, der für das Feld 
hStyle der Funktion CreateWindow verwendet wird. 
Zusätzlich können Sie alle gewünschten Fenster- und Steue- 
rungsstilattribute damit logisch oder (! !) verknüpfen. (Eine 
vollständige Liste finden Sie in den Tabellen 3.4 und 3.5 in 
Microsoft Windows Software Development Kit Program- 
mer’s Reference Version 2.x.) 

Dann folgt dtilControlClass für die Definition der 
spezifischen Steuerungsklasse des Feldes. In Listing 4 ist 
eine Liste der vordefinierten Klassen zu sehen. (Eine um- 
fassendere Beschreibung jeder Steuerungsklasse bietet die 
Tabelle 3.3 in Microsoft Windows SDK Programmer’s 
Reference Version ?2.x.) 

Das Feld dtilText wird für den Text verwendet, der in 
der Steuerung angezeigt werden soll. Wenn das erste Byte 0 
ist, wird kein Text angezeigt; wenn das erste Byte nicht 0 ist, 
wird ein mit 0 abgeschlossener String erwartet. 


> IDM_MODAL 108 
> IDMMODELESS 118 
> IDMONE 128 


IDDEDIT 
IDCHECK 


3825 
3026 


/* Control class codes */ 
| BrBd /* 
AxB1 /* 
dxB2 /# 1 
#define LISTBOXCLASS Bx83 /* 
#define SCROLLBARCLASS #x84 /* 


typedef struct DialogHeader{ 
long dtStyle; 
BYTE dtlItemCount; 
int dtkX; 
int dtY; 
int dtcX; 
int dtcY; 
} DLGHDR; 


/* The following 3 header itens are variable strings 
so not part of DLGHDR */ 


/* char dtResourceName[]; */ 
/* char dtClassNane[]; * 
/* char dtCaptionText[]; * 


typedef struct Dialogltem ( 
int dtilX; 
int i 
int 
int 
int 
lon | 
BTTE dtilGontroltlass; 
|} DLGITEM; 


/* The following control items are variable 
so not part of DLGITEM */ 


/* char dtilText[]; * 
/*  BYTE dtillnfo; #/ 





Listing 4: Die Header-Datei DLGBOX .H. 


Das Feld dtilInfo entspricht dem letzten Feld der 
Struktur WNDCLASS, cbWndExtra. Es ermöglicht es uns, 
zusätzliche Bytes an die Struktur WNDCLASS zu hängen. Wir 
können diese zusätzlichen Informationen dann vom Fenster 
mit den Funktionen GetWindowWord, GetWindowLong, 
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SetWindowWord und SetWindowLong abfragen oder 
speichern. Sobald wir alle Informationen zusammen haben, 
können wir sie als Parameter der Funktion CreateDia- 
logItem übergeben. Wenn alles richtig vonstatten geht, ist 
der globale Speicher erweitert, die neue zusätzliche Infor- 
mation an das Ende kopiert und der Feldzähler (iItems) 
um eins hochgezählt worden. Dadurch brauchen wir nach 
Übergabe des letzten Steuerungsfeldes in der Dialogbox die 
Felder in der Dialogbox nicht noch einmal durchzuzählen. 


EndDialogHeader 


Die letzte Funktion, die in unserer Beispielanwendung ver- 
wendet wird, ist EndDialogHeader. Hier müssen wir her- 
gehen und das Feld dtItemCount in DialogHeader, das 
sich nun ım globalen Speicher befindet, direkt ändern. Wir 
erledigen das, indem wir erst den Speicher locken und dann 
den Zeiger über die korrekte Anzahl Byte bringen. Dann 
ändern wir den Speicherwert auf die richtige Feldanzahl, die 
wir in iltems in der Funktion CreateDialogItem mit- 
gezählt haben. Dann wird der Speicher wieder »entlockt«. 
Wenn die Funktion EndDialogHeader den Speicher 
ändern kann, übergibt sie eine Handle auf den globalen 
Speicher, der unsere neu angelegte Dialogtabelle enthält. 

Jetzt, wo die Dialogstruktur aufgebaut ist, können wir 
die Dialogtabelle an eine unserer Dialogbox-Funktionen 
übergeben. Wenn wir eine modale Dialogbox wollen, brau- 
chen wir nur die Funktion DialogBoxIndirect mit der 
Handle auf den globalen Speicher aufrufen. Wenn wir 
jedoch eine moduslose Dialogbox wollen, ist ein weiterer 
Schritt notwendig - wir müssen den globalen Speicher 
locken, damit wır einen Long-Pointer als zweiten Parameter 
der Funktion CreatDialogIndirect übergeben können. 
Außer dem Locken des Speichers besteht der Hauptunter- 
schied zwischen DialogBoxIndirect und CreateDia- 
logIndirect darin, daß DialogBoxIndirect auch die 
Funktion DisableWindow aufruft, um die Fensterhandle, 
die als dritter Parameter übergeben wurde, abzuschalten. 
Wenn diese Handle nicht die Handle des übergeordneten 
Fensters ist, findet die Funktion DialogBoxIndirect sie 
heraus und schaltet sie ab. 


Abschluß 


Dynamische Dialogboxen unterscheiden sich nicht stark von 
ihren statischen Gegenstücken. Die Möglichkeit, sie anzule- 
gen wenn man sie benötigt, ist jedoch ein sehr nützliches 
Feature, das zusätzliche Fexibilität bringt. Nachdem Sie nun 
gelernt haben, wie Sie die Dialogtabelle aufbauen, die die 
beiden neuen Funktionen benötigen, und auch verstehen, 
was die Funktionen in DLGTEMP.C tun, haben Sie alle not- 
wendigen Tools, um damit zu beginnen, Anwendungen zu 
erstellen, die Dialogboxen enthalten, die »nebenbei« ent- 
standen sind. 

Don Hasson 
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/* DLGBOX.C -- version 1.00 Demonstrates how to use the 
BALERTIRINEEN and CreateDialogIndirect 
funct 








include <windows.h> 
include "dlgbox.h" 


/* List of functions used in this module. */ 

BOOL FAR PASCAL InitDiabox(HANDLE, HANDLE, int); 

LONG FAR PASCAL D1gboxWndProc(HANDLE, unsigned, WORD, LONG); 
BOOL FAR PASCAL DIS ogBonhIndovProc(HANDLE ‚unsigned, HORD ‚LONG); 
| BOOL BuildDialog( 


/* The following functions are found in the DLGTEMP module. 
| They are used to build the dialog structure that will be 
passed to the DialogBoxIndirect or CreateDialogIndirect 
function. 













en ne Funetions defined in another module ------------ 
extern BOOL FAR PASCAL CreateDialogHeader (LONG, BYTE,int, 
int, int, int ,LPSTR,LPSTR,LPSTR); 
extern BOOL FAR PASCAL GreateDialogiten(int,L LONG, BYTE,int, 
extern HANDLE 








int int ,int,LPSTR,BYTE ); 
FAR PASCAL EndDialogHeader ( }; 







/* handle to Instance af 
/* Dialog processing routine */ 
/* handle for modeless > box Y 

ed # 


/* Handle to created Fr: template ” | 
emplate % 





hInst; 
FARPROG nigfest 
1 


st = NULL; 
BOOL nModeless; /* flag set by menu selec 
hD1gTe 


1pDTemplate; /* Long pointer to dialog 











= mo =-— |. |... [| oo. . | | | | | 


nMain 
int PASCAL WinMainihInstance,hPrevInstance ‚1ps2CodLine, cadShow) 
HANDLE hinstance „ hPrevInstance; 









LPSTR 2 IlpszCodLine; 
I cndShow; 
MSG msg; 






4 
BOOL bResult; 


if (hPrevInstance) /* do not allow more than one instance #/ 
return FALSE; 


/* Modeless dialog message processed flag */ 







InitDiabox ( hInstance, hPrevInstance, cadShow ); 


while ( Ba ES  EEDERSE, NULL, 8, dB )) { 
bResult = FALSE; 







/* this structure allows checking for multiple 
modeless dialog boxes */ 


if ( hDlgTest != NULL ) 
bResult = IsDialogMessage( hDlgTest, 


if ( tbResult ) { 
Translatellessage( (LPNSG)&nsg); 
Dispatchlessage( (LPHSG)Ansg): 










(LPMSG)&msg ); 















} 
return msg.wParam ; 








Er Elan en Se 





ıBOOL FAR PASCAL InitDiabox{ hInstance, hPrevInstance, cmdShow ) | 
HANDLE hinstance; 

HANDLE hPrevInstance; 
er cndShow; 


HNDCLASS wcDiaboxGlass; 
HRND hund; 




















= (LPSTR) "Diabox"; 
= hInstance; 

= DlegboxhWndProc; 

= LoadCursor( NULL, 


weDiaboxClass.1IpszClassNane 
weDiaboxClass.hInstance 
weDiaboxClass.1IpfnWndProc 
weDiaboxClass.hCursor 





IDG _ARROW ); | 








weDiaboxClass.hlIcon = ee. 

" con" ); 
weDiaboxClass.IpszMenuNane = (LPSTR})”dlgbox” innen added*/ 
weDiaboxClass. ‚hbrBackground = Getstockönjeet TE Be 
weDiaboxGlass.style 
weDiaboxClass.cbClsExtra = 
veDiaboxClass.cbWndExtra = 8: 


RegisterClass ( (LPWNDCLASS) &wcDiaboxClass ); 


hund = CreateWindow( (LPSTR)"Diabox”, 

(LPSTR)"Dialo Box”, 
WS OVERLAPP INDOK 
CW USEDEFAULT, 
CW _USEDEFAULT, 
CW_USEDEFAULT, 
CW USEDEFAULT, 
(HWND) NULL, 
(HMENU)NULL , 
(HANDLE)hInstance, 

(LPSTR)NULL 


hInst = hInstance; 


ShowWindow( hknd, cmdShow ); 
UpdateWindow( hund ); 


return{ TRUE }); 


parent's window procedure 


|LONG FAR PASCAL DlgboxWndProc( hund, message, wParam, 1lParam ) 
HHND hund; 

unsigned message; 

WORD wParan; 

| LONG lParan; 


PAINTSTRUCT ps; 
int iResult; 


/* instance saved for dialog box */ | 


GlobalFree( et ); 
return FALSE 


1pDlgTest = MakeProcInstance( 
(FARPROC) DialogBoxkindowProc, 
hInst ); 


if (1pDigTest == NULL) { 
MessageBox( GetFocus(), 
"MakeProcInstance failed!”, 
"ERROR”, MB_OK ); 
GlobalFree( hDlgTenp ); 
return FALSE; 


} 
hDlgTest = EEBBSRTIRLORENEELBE I 
1 Art ate, hWnd, 1pDl en ); 
} /%* exit if Buil ialog didn't vor 


break; 


default: 
return DefhWindowProc(hWnd message ‚wParam,1Paran); 
break; 


case WM PAINT: 
BeginPaint( hund, (LPPAINTSTRUCT)&ps ); 
En nt ( hund, (LPPAINTSTRUCT)&ps ); 
break; 


case WM DESTROY: Be | 
FreeProcInstance ( (FARPROC)1pDlgTest ); 
OT MIRSORERL B ); 
reak; 


default: 
return( DefkindowProc(hWnd,message,wParan,1lParan)); 


return( AL ); 


switch (message) { 
case WM COMMAND: [# ------------- Build dialog routine --------- mm #/ | 

switch (wParan) { /#* 

* This routine passes all the necessary information to the 

* dialog functions in DLGTEMP.C that will build the dialog 


* table. 
*/ 


case IDM_MODAL: 


if ( hDigTest == NULL ) { 
/* allow only one dialog up at a time */ 
nModeless = FALSE; 
tal BuildDialog(hhnd) == TRUE) { 
1pDigTest = MakeProcInstance( 
(FARPROC) DialogBoxhindowProc, 
hInst ); 


if (1pDlgTest == NULL) { 
MessageBox( GetFocus(), 
"MakeProcInstance failed!”, 
"ERROR", MB_OK ); 
GlobalFree({ hDlgTenp ); 
return FALSE; 


BOOL BuildDialog(hWnd) 
OR hhnd; 


BOOL bResult; 
HCURSOR höldCursor; 


/* Build the Dialog header */ 


bResult = CreateDialogHeader( Eis 
WS BORDER ! WS_CAPTION | WS_DLGFRAME | WS_VSCROLL | 
WS HSCROLL | WS_SYSMENU WS GROUP ı WS_TABSTOP | | 
WSSIZEBOX | WSTVISIBLE | WS POPUP, /* window style */ 
(BYTE)12, 24, 12, 188, 168, 7*coordinates of Dialog box.*/ | 
"dlgtenmp”, /* nenu */ 

ze /* class name %/ 

/* Caption bar */ 


/* Handle to old mouse cursor */ 


iResult = DialogBoxIndirect(hInst, hDlgTe 


hWnd, 1pDlgTes 
} 
break; 


case IDM MODELESS: 


if ( hDlgTest == NULL ) { 
/* allow only one dialog up at a time #/ 
nModeless = TRUE; 
if ( BuildDialog(hhnd) == TRUE) { 
aha oa = GlobalLock{ hDlgTenp ); 
if (1pDTemplate == NULL) { 
MessageBox( GetFocus(), 
"Could not lock memory.", 
"Diabox”, MB_OK ); 


"A test Dialog Box” ); 


if (bResult == FALSE) { 
MessageBox( GetFocus(), 
"Not enough memory.” 
"Diabox”, MB_OK ); 
return FALSE; 


höldCursor = SetCursor( LoadCursor (NULL, IDC_WAIT) ); 


/* Each call to CreateDialogltem is an item to be placed 
/* inside the dialog box 

/* This next comment line is the value that is passed 

/* id, style, class, x, y, cx, cy,text, extrabytes 
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a az IDCHECK,DId, 8, 
45, 12, "&Ck box" ‚Bxdß );/* ck box %/ 
GreateDisloglient 3 3981, DI, 
ß, "dlgicon” ‚BxfB );/* icon */ 
a a5 3982, DI2 - 
16, „" 0xdd );/* black box#/ 
CreateDialogIten( 3983, a y ? 
FR );/* rect * 


CreateDialogIten( 3004, DI4, 8, 
6, 132, 48, 10,”L Justify”,Oxdd );/* 1ft text */ 


GreateDialoglten. 3 3005, = 
"M Edit”,2xdd );/* muli edt */ 


GreateDialoglien( 3 3086, DI6, 8, 
54, "15" Bxdd );/* list box */ 
GreateDialogliend 3 3987, ß, 
8, "u s”.dxd8 );/*vert scrl %/ 
CreateDialoglten( 3988, ß, 
6, 47, 47, "h s”,Bxdd );/*horz scrl */ 
CreateDialoglten( 3009, - SPUR a 
6, 2, 36, "sroup”,Bxdd );/* group box*/ 
GreateDialngTient | IDCANCEL, DINGE, 8, 
182, 112, 24, 14, ”"%Push”,Bxdd );/*push but */ 
GreateDialoglten( 32, DIN, 
6, 12, "Lradio” ‚Böxd8 );/*radio but */ 
Crentedialogiten. IDOK, DI12, 8, 
24, 14, "gOk" ,DxBd );/*def buton */ 
CreateDialoglIten( 3913, DI13, 8, 
6, ‚44, 12,"&L Ck box” ‚Bxdd );/*left ckbox*/ 
CreateDialogltem( 3014, DI 
‚38, 12, "g3auto”, Bxdd );/*3 autoton */ 
GreateDieloglient 5 3015, I, 98, 
48, 12, "C Edit", dxdd );/*edit cent */ 
ea: Iten( „016, DIi6, 8, 
‚48, 12, "R Edit”, Bxdd );/*rt edit */ 
GrenteDtaloglten "IDDEDIT, DI17, 
48, 12, ”L Edit”, DxßO );/* L edit #*/ 
CreateDialo Iten( 3818, DI18, 8, 
8, 45, 54, 32, ”no sort", ÖxBd );/* 1b w/out */ 
GreateDialoglien( 3 3819, DI19, 8, 
59, 18, "Center” ‚BxBd );/* CEN text */ 
GresteDialogltenl 3 3028, DI2B, 
46, 18,"R Justify” ‚Bxdd );/* RIG text */ 


SetCursor( hOldCursor ); 
/* Get the handle to the new dialog table */ 


/* ei ainise template, return hDlgTenmp. */ 
ir = EndDialo 
hOIgTenp ap == NULL) 
 loba Free(hDl Ten); 
MessageBox( GetFocus(), 
"End dialog routine.” 
"Error!”, MB_OK ); 
return FALSE; 


return TRUE; 


dialog box window procedure 


/ 
* This routine ee 3 all the message for the dialog that 


2 was dynanically created 
%* 


BOOL FAR en DialogBoxWindowProc(hDlg,message,wParan,1Param) 


TempEdit[24]; 
hListBox, hListBoxNS ; 


switch(message) { 
case WM _INITDIALOG: 
hListBox = GetDlgltem( hDlg, 3086 ); 
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SendMessage(hListBox, LB ADDSTRING, 
(LONG) (LPSTR)"”Sorted”); 
SendMessage(hListBox, LB ADDSTRING, 
(LONG) (LPSTR)”CCC"); 
SendMessage(hListBox, LB_ADDSTRING, 
(LONG) (LPSTR)"”AAA”); 
SendMessage(hListBox, LB ADDSTRING, 
(LONG) (LPSTR)”BBB”); 


hListBoxNS = GetDlgItem( BDig See ); 

SendMessage(hListBoxNS, LB NG, 
(LONG G)LLPSTR)"NOT Sortedt”);. 

SendMessage(hListBoxNS, LB ADDSTRING, 2, 
(LONG) (LPSTR)"COC"); 

SendMessage(hListBoxNS, LB ADDSTRING, 8, 
(L LONG) (LPSTR)"ARA") ; 

SendMessage(hListBoxNS, LB ADDSTRING, ß, 
(LONG) (LPSTR)"BEB"); 


SetFocus( GetDlgltem( hDlg, IDOK ) ); 
return(TRUE); 


break; 
case WM COMMAND: 
switch( wParam ) { 


case IDCHECK: /* Check on */ 
CheckDlgButton(hDlg, IDCHECK, 
tIsDlgButtonChecked(hD1g, IDCHECK)); 


break; 
case IDM ONE: /* One menu item */ 


MessageBox(GetFocus(), (LPSTR)"One selected.”, 
(LPSTR)”Menu item”, MB_OK ); 
break; 


case IDOK: /* Ok button */ 


GetDlgItemText( hDlg, IDDEDIT, Te arrrig 24 ); 

MessageBox(GetFocus(), (LPSTR)TenpE dit, 
(LPSTR)"Edit:”, MB_OK ); 

/* fall through to IDCANCEL #/ 


case IDCANCEL: /* Cancel push button */ 


hDlgTest = NULL; 
if ( nModeless == FALSE ) 
EndDialog ( hDlg, TRUE ); 
else 
DestroyWindow( hDlg ); 
return( TRUE ); 


default: 
return( TRUE ); 
} /* end wParam switch */ 
break; /%* end wm command */ 


case WM DESTROY: 
hDlgTest = NULL; 
while (GlobalFlags(hDlgTemp) & GMEM_LOCKCOUNT) 
GlobalUnlock( hDlgTemp ); 
if (hDlgTenp) 
GlobalFree( hDlgTenp ); 
break; 


default: 
return( FALSE ); 


} /* end message switch */ 
return( FALSE ); 





Listing 5: Die C-Quelldatei DLGBOX .C. 





Windows 










/* DLGTEMP.C -- version 1.08 
This module supplies the necessary functions 
used to create a dialog box template in global 
memory and to pass the handle on to either the 
DialogBoxIndirect or CreateDialogIndirect functions. 







I#include (windows.h> 
|Zinclude "dlgbox.h” 












/* forward references */ 
KORD 1strlen( LPSTR ); 
SetStyleClass(int); 







: hDlgTemplate; /* Handle to dialog template memory */ 
WORD wüffset; /* Current memory offset 








(updated by CDH & CDI) */ 
BYTE iltens; /* number of items in dialog */ 
DLGITEM Diglten; /* Dialog item structure */ | 
IN mern Greate Diäine Header Tome: #/ 






* This routine allocates a Fa of global memory 

* and then fills in the dialog header structure and saves the 

| = information in global menory. | 
# 










BOOL FAR PASCAL a Style, ItemCount, X, Y, 

cä, cY, Resource, Class, Caption) 
LONG Style; /* Dialog box Style */ 
BYTE ItemCount; /* Control count for dialog box # 
int X; /* Dialog box top left column #/ 











int Y; /* Dialog box top row */ 
int cX; /* Dialog box width */ 
int cY; /* Dialog box height #/ 
LPSTR Resource; /* Dialog box resource string */ 
LPSTR Class; /* Dialog box class string * 
aa Caption; /* Dialog box caption */ 
WORD ResourceLength, /* Length of resource string */ 
GlassLlength, /#* Length of class string % 
tionLength; /* Length of caption Strin #/ 





DWORD dwfMemLength; /* Dialog header menory 11locstion 









length */ 
LPSTR 1pHdrData; /* Long pointer to locked dialog 
template memory */ 
DLGHDR DlgHdr; /* Dialog header structure * 
LPSTR 1pDighdr; /* Long pointer to dialog header 
structure */ 
int 4; /* Loop index u 4 





‘* Initialize memory offset #/ 





wöffset = B; /* set memory offset to ZERO */ 
iltens = 8; /* set number of items in dialog to ZERO */ 





/* Determine string lengths (including terminating null ) */ 





ResourceLength = 1strlen( Resource ) + 1; 
ClassLength = lstrlen{ Class ) + 1; 
CaptionLength = 1lstrlen{ Caption ) +# 1; 










/*Determine length of memory to allocate for ee; header#/ | 
dwMemLength = (DWORD)( sizeof( DLGHDR ) + ResourceLength + 
GlassLength + CaptionLength ); 









’* Allocate dialo 


i template memory for dialog header 
and obtain handl 


e # 





if ( !C hDlgTemplate = GlobalAlloc(GMEM MOVEABLE | 
GMEM ZEROINIT, 
dwMemLength ) ) ) { 







MessageBox( GetFocus(}, 
(LPSTR)"GlobalAlloc Error”, 
(LPSTR)"CDH", MB_OK ); 


return FALSE; /* GlobalAlloc failed */ 













/* Lock allocated memory for modification */ 
if ( lpHdrData = GlobalLock( hDigTemplate ) ) { 


/* Set dialog header structure data to passed in parms #/ 
D1gHär .dtStyle = Style; 








DleHdr..dtItemCount = 1; /* set to zero */ 
DIEHär .dtX = X: 

DIeHdr.dtY = Y; 

DIeHdr .dtCX = 0X; 

DigHdr .dtCY = cy; 







/* Get pointer to A on Marla structure */ 
1pD1gHdr = (LPSTR)&DIgHAr ; 






/* Copy a header structure to allocated menory */ 
for (1 = 8; I & sizeofi( DLGHDR ); i++ ) 
*]pHdrData++ = *1pDlgHdr++; 






/* Copy resource string to allocated nenory */ 
while ( ( *1pHdrData++ = #Resource+* ) }; 






/* Copy class string to allocated memory */ 
while ( ( *1pHdrData++ = *Class++ ) ); 





/* Copy caption string to allocated menory */ 
while { ( *lpHdrData++ = *Caption+ ) ); 






/* Adjust memory offset past memory allocated for dialog 
header #/ 
wöffset += (WORD)( sizeof( DLGHDR ) + ResourceLength + 
ClassLength + CaptionlLength ); 







/* Unlock allocated memory */ 
GlobalUnlock{ hDlgTemplate ); 





return TRUE; /# everything worked so far, return TRUE */ 





} 
else { 
MessageBox( GetFocus(), 
(LPSTR)"GlobalLock Error”, 
(LPSTR}"CreateDialogHeader”, MB_Ok }; 
GlobalFree( hDlgTenplate ); /* free allocated menory */ 
return FALSE; /* return null handle 
indicating failure #/ 










Re Graste DIEBE I ne 





* This routine fills in the dialog item structure and 
* saves the information in global memory after resizing it. 
*/ 


BOOL FAR PASCAL CreateDialogItem( iCtrlID, 15tyle, Class, X, Y, 
cX, cY, Text, Extraßytes ) 

int iCtrlID; /* Control ID */ 

LONG 1Style:; /* Control style */ 

BYTE Class: /* Control class */ 

int % /* Control top left colum */ 










int %: /* Control top row u 
int ck; /* Control width # 
int cY; /* Control height #f 
ILPSTR Text; /* Control tex #/ 







ExtraBytes; /* Control extra bytes count */ 










LPSTR I1pCtrlData; /* Long pointer to locked dialog 
template memory */ 

LPSTR lpDlglten; /* Long pointer to dialog control 
structure ef 
#* 







int i: /* Loop index 
WORD TextLength; /* Length of control text string af 
DWORD dwMemLength; 
HANDLE hCurDlgTenp; 











Diglten.dtilX = 
Diglten.dtilY = Y; 






Digltem.dtilCX = cX; 
Digltem.dtilCY = cY; 





Digltem.dtillD 
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Windows 













if (Class == (BYTE)B) 
SetStyleClass( (int)l5tyle); 
se { /* default, may change in next function #*/ 
DlgItem.dtilControlClass = Class; 
DigItem.dtilStyle = 1Style; 


} 

TextLength = 1strlen( Text ) + 1; 

dwMemLength = (DWORD)(wOffset + sizeof(DLGITEM) + 
TextLength + sizeof(BYTE) ); 


hCurD1gTemp = GlobalReAlloc( hDlgTemplate, duMenLength, 
u“ GMER MOVEABLE) ; 






el 







if ( hCurDlgTemp == NULL) { 

MessageBox ( GetFocus(), 
(LPSTR)”global lock”, 
(LPSTR)"Failedt”, MB_OK); 

GlobalFree( hCurDlgTenp ); 
return FALSE; 


hDlgTemplate = hCurDlgTenp; 












/* Adjust pointer to reallocated memory bypassing 
existing data */ 


if ( (lpCtriData = GlobalLock(hDlgTenplate)} == NULL) { 
MessageBox ( GetFocus(), 
(LPSTR)"global lock”, 
(LPSTR)"Failedt”, MB_OK); 
' GlobalFree( hDlgTemplate ); 









lpttriData += wOffset; 


/* Get pointer to dialog control structure */ 
lpDlglten = (LPSTR}&DlgIten; 






/* Copy dialog control structure to allocated menory */ 
for ( i=8; i<sizeof{ DLGITEM ); i+ ) 
*\pGtrlData++ = #*1pDigltem++; 






/* Copy control test string to allocated memory */ 
while ( ( *lpGtriData++ = *Text+ ) ); 





/* Copy extra byte count to allocated memory */ 
*]pCtrlData = Extraßytes; 





/* Adjust memory offset past memory reallocated for 
dialog control /_ | 
wOffset += (WORD)( sizeof( DLGITEM ) + 
TextLength + sizeof( BYTE ) ); 








/* Unlock reallocated memory */ 
GlobalUnlock( hDlgTenplate ); 





iltens++; /* bunp up number of items in dialog */ 






return{ TRUE ); /#* return successful #/ 







ne End DisIog Header 





* This routine changes the number of itens in the 

* dialog header and then returns a handle to the global 
TER 
* 






aka FAR PASCAL EndDialogHeader() /* end dialog header func*/ 


LPSTR 1pCtriData; /* Long pointer to locked dialog 
template menory */ 


IpttrlData = GlobalLock( hDlgTemplate )}; 
if (lpCtrlData == NULL) { 

MessageBox ( GetFocus(), 
(LPSTR)"”Global lock”, 
(LPSTR)"Failedt", MB _OK); 

GlobalFree( hDlgTenplate ); 
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/* 5th byte is address to / of items in dialog */ 
lpCtrlData++; 
lpCtrlData+; 
lpttrlDatat++; 
lpCtrlData++; 


/* set the number of items in control */ 
*IpCtrlData = (BYTE)iltens; 








/* Unlock allocated memory */ 
GlobalUnlock( hDlgTemplate ); 


/* Return the handle to the Dialog Template */ 
return (hDlgTeaplate); 











je -——- - List of predefined dialog itens -----—- 
# 
* This routine defines a list of predefined dialog itens. 
This allows the user to just pass a number to get the 
attributes of a pre-defined control. 

You can add to this list or modify this to best fit 
your needs. 






EEE: = 





Warning: If you change one of the styles, it could effect 
other controls that expect the old behavior. 






aa 






void SetStyleClass(iStyle) 
int iStyle; 


/* if a iStyle is given 
then dtilControlClass will take on the default value. */ 











switch ( iStyle ) { 
case DIß: /* check box *#/ 
Dlgltem.dtilControlGlass = BUTTONCLASS ; 
DigItem.dtilStyle = BS_CHECKBOX I WS TABSTOP | 
WS_CHILD | WS_VISIBLE ; 










break; 
case DI]: /* icon */ | 
DigItem.dtilControlClass = STATICCLASS ; 
DigItem.dtilStyle = SS_ICON I WS_BORDER | 
WS_CHILD ! WS_VISIBLE ; 







break; 
case DI2: /* black box #/ 
DlgItem.dtilControlGlass = STATICCLASS ; 
Diglten.dtilStyle = SS_BLACKRECT | WS_CHILD | 
WS VISIBLE ; 







break; 
case DI3: /* rectangle */ 
Digltem.dtilControlClass = STATICCLASS ; 
DigItem.dtilStyle = SS_BLACKFRAME | WS_CHILD ı 
WS VISIBLE ; 
break; 


case DI4: /* left static text #/ 
Digltem.dtilControlClass = STATICCLASS ; 
DigItem.dtilStyle = SS_LEFT | WS_CHILD i 
WS_VISIBLE ; 
break; 


DIS: /* nultiline edit box */ 
DiglItem.dtilControlClass = EDITCLASS ; 
Digltem.dtilStyle = ES_LEFT ES_MULTILINE 

ES_NOHIDESEL | ES_AUTOVSCROLL | 
ES AUTOHSCROLL | 

WS VSCROLL | WS HSCROLL | 
WS_BORDER | WS TABSTOP | 
WSCHILD } WS_VISIBLE ; 










cas 


1; 










break; 
case DI6: /* list box - sorted #/ 
Dleltem.dtilControlllass = LISTBOXCLASS ; 
DigItem.dtilStyle = LBS STANDARD | WS_CHILD | 
WS_VISIBLE ; | 






break; 
case DI?: /* vertical scrollbar *#/ 
DigItem.dtilControlClass = SCROLLBARCLASS ; 
Digltem.dtilStyle = SBS VERT | WS_CHILD | 
WS_VISIBLE - 
break; 









L Er TE _ TE TE Do u 1; 











case DIB: /* horizontal scrollbar */ 
DlgItem.dtilControlClass = SCROLLBARCLASS ; 
DigItem.dtilStyle = SBS HORZ | WS_CHILD | 
WS_VISIBLE ; 
break; 
case DI9: /* group box */ 
DlgItem.dtilControlllass = BUTTONCLASS ; 
DlgItem.dtilStyle = BS_GROUPBOX | WS_TABSTOP | 
WS_CHILD | WS_VISIBLE ; 


break; 
case DIid: /* Push button %*/ 
Dlgltem.dtilControlClass = BUTTONCLASS ; 
DigItem.dtilStyle = BS_PUSHBUTTON ı WS TABSTOP ı 
Ko WS_CHILD | WS_VISIBLE ; 
reak; 


case DIN]: /* radio button */ 
Digltem.dtilControlClass = BUTTONCLASS ; 
DigIten.dtilStyle = BS RADIOBUTTON | WS TABSTOP | 
WS CHILD I WS_VISIBLE ; 


break; 
case DI12: /* default push button #/ 


DigItem.dtilControlClass = BUTTONCLA 


55. 
DigItem.dtilStyle = BS_DEFPUSHEUTTON | WS TABSTOP | 


WS_CHILD I WS_VISIBLE; 
break; 


case DI13: /* left check box */ 
Digltem.dtilControlClass = BUTTONCLASS ; 
DigItem.dtilStyle = BS_LEFTTEXT | BS CHECKBOX | 
WS_TABSTOP | WS_CHILD | 
WS VISIBLE ; 


break; 
case DI14: /* 3 auto state button #/ 
Digltem.dtilControlClass = BUTTONCLASS ; 
DigItem.dtilStyle = BS_AUTO3STATE | WS TABSTOP | 
WS CHILD | WS VISIBLE ; 
break; 
case DI15: /* centered edit control */ 
DigItem.dtilControlClass = EDITCLASS ; 
Diglten.dtilStyle = ES_GENTER | ES MULTILINE | 
WS _BORDER | WS TABSTOP | 
WS_CHILD ı WS _ VISIBLE ; 


break; 
case DI16: /* right edit control */ 
Diglten.dtilControlClass = EDITCLASS ; 
Dlglten.dtilStyle = ES RIGHT | ES MULTILINE | 
WS _BORDER | WS TABSTOP | 
WS_CHILD | WS_VISIBLE ; 


ak 


break; 





case DI17: /* left edit control %/ 


DigItem.dtilControlClass = EDITCLASS ; 
DigItem.dtilStyle = ES LEFT |! WS_BORDER | 
WS-TABSTOP | 
WSCHILD | WS VISIBLE ; 


break; 


case DI18: /* listbox w/out sort #/ 
Diglten.dtilGontrolClass = LISTBOXCLASS ; 
Diglten.dtilStyle = LBS NOTIFY | WS_BORDER | 
WS_VSCROLL | 
WS”CHILD | WS_VISIBLE ; 
break; 
case DI19: /* center static text %/ 
DigItem.dtilControlClass = STATICCLASS ; 
Digltem.dtilStyle = SS_CENTER | WS BORDER | 
WS”CHILD | WS VISIBLE ; 


break; 
case DI: /* right static text */ 
Diglten.dtilGontroltlass = STATICCLASS ; 
DigIten.dtilStyle = SS_RIGHT | WS_CHILD | 
WS_VISIBLE ; 
break; 
default: /%#* left edit control */ 
DigItem.dtilControlClass = STATICCLASS ; 
DlgItem.dtilStyle = SS _LEFT | WS_CHILD | 
WS VISIBLE ; 
break; 


} /* end switch #/ 


WORD Istrlen( Ipeste ne ) 

LPSTR Ips2String; /* String to check */ 

[3 
WORD Length; /* Length of string */ 

for ( Length = #; *lpszString++ != '"\@"; Length+ ); 


return( Length ); 





Listing 6: Das Listing des Beispielprogramms DigTemp mit 
dynamischen Dialogboxen. 
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MS-DOS 4.0 





Ein neues, freundliches DOS 


Microsoft kündigte Ende Juli die Version 4.0 von 
MS-DOS an. Die neue Version zeichnet sich vor 
allem durch Funktionen aus, die es dem Anwen- 
der erlauben, größere Festplatten und Haupt- 
speicher-Erweiterungsboards zu nutzen, sowie 
eine visuelle Bedienungsoberfläche. 


Ms-Dos 4.0 bringt Verbesserungen in den Bereichen 
Bedienung, Verwaltung großer Festplatten-Dateien, Datei- 
system und EMS-4.0-Unterstützung. Die Version 4.0 bietet 
neue Befehle wie MEM und eine Reihe von Verbesserun- 
gen bei alten Befehlen wie FORMAT, DELETE und 
GRAPHICS. 

Die Verwendung der Versionsnummer 4.0 verursachte 
bei Kennern zunächst Verwunderung, denn eine MS-DOS 
Version 4.0 ist bereits seit langem auf dem Markt. Sie bietet 
einige Möglichkeiten für Multitasking in Netzwerken, ist je- 
doch nur von sehr wenigen Herstellern verwendet worden. 
Microsoft bezeichnet die jetzt angekündigte Version als 
»die offizielle Version 4.0«. 


Die MS-DOS-Shell 


Die für den Benutzer wichtigste Erweiterung von MS-DOS 
4.0 ıst die MS-DOS-Shell. Sie ist eine bildschirmorientierte, 
menügesteuerte Betriebssystem-Erweiterung für die Datei- 
bzw. Verzeichnisverwaltung und das Laden von Anwendun- 
gen. Sie kann über die Tastatur oder mit einer Maus be- 
dient werden. Der speicherresidente Teil der MS-DOS- 
Shell belegt 4 Kbyte Hauptspeicher-Kapazität. 

Eine DOS-Benutzerfläche von Microsoft gibt es schon 
seit einiger Zeit, sie wird zum Beispiel von Zenith unter 
dem Namen DOS-Manager angeboten. Die DOS-Shell hat 
damit nur noch wenig gemeinsam. Von der Darstellung und 
Handhabung her ist sie der OS/2-Presentation-Manager- 
Bedienungsoberfläche sehr ähnlich (Bild T). Mit Hilfe der 
neuen DOS-Oberfläche kann der Anwender unter Zuhilfe- 
nahme von Pull-down-Menüs Anwendungsprogramme star- 
ten und DOS-Befehle aufrufen. Sie unterstützt den Anwen- 
der bei der Ausführung häufig benutzter Datei-Operatio- 
nen, wie Kopieren und Löschen (Bild 2). Durch den Einsatz 
von Pull-down-Menüs und Dialogboxen braucht der 
Anwender sich nun die genauen Namen und die Syntax die- 
ser Befehle nicht mehr unbedingt merken. Er kann auch 
seine Anwendungsprogramme direkt von der neuen Bedie- 
nungsoberfläche aus starten. Bei der Arbeit mit der DOS- 
Shell (wie auch dem Installationsprogramm) kann man 
jederzeit mit [F1) kontextsensitive Hilfe anfordern. 

In der DOS-Shell können Anwendungsprogramme in 
das Hauptmenü (Start Programs) aufgenommen und so auf 
einfache Weise gestartet werden. Wenn viele Anwendungs- 
programme aufgenommen werden, können sie auch grup- 
piert und in Untermenüs aufgeteilt werden (Bild 1). 
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start Programs | 


Hain Group 
To select an item, use the up and down arrows. 
To start a program or display a new group, press Enter. 


005 Utilities... 
Kore: 4 
Select this item to format, copy, or 
compare diskettes, to backup or restore 
files and to set the system date and time. 


MOTE: The backup and restore options are 


Shi ft+F9-Lommand Prompt 





Bild 1: Das Hauptmenü der DOS-Shell ist erweiterbar und 
der Benutzer bekommt auf Tastendruck Hilfeinformationen. 


Die Verwaltung von Dateien findet in einem weiteren 
Programm, dem File System statt (Bild 2). Hier können ın 
einem oder zwei Fenstern Dateien aus verschiedenen Ver- 
zeichnissen angezeigt und verwaltet werden. Wahlweise 
können auch alle Dateien ın allen Verzeichnissen sortiert 
angezeigt werden. Dateien können mit Cursortasten oder 
der Maus einzeln oder in Gruppen ausgewählt werden. Die 
ausgewählten Dateien kann man dann kopieren, umbenen- 
nen, löschen, ansehen usw. Bei Beendigung des File 
Systems wird zum Hauptmenü (Start Programs) zurückver- 
zweigt. Natürlich können auch unter der DOS-Shell wie 
bisher Befehlszeilen verwendet werden. 

Die Möglichkeiten und die Benutzerschnittstelle der 
MS-DOS-4.0-Shell sind konsistent mit der Shell für das MS- 
OS/2-Betriebssystem Version 1.1, dem Presentation Mana- 
ger. Microsoft hat überdies angekündigt, daß eine entspre- 
chende Oberfläche in einer zukünftigen Version von Micro- 
soft Windows verfügbar sein wird. Somit bieten diese Pro- 
gramme den Anwendern eine durchgängige Bedienerober- 
fläche von einfachen über mittlere bis zu Hochleistungs-PC. 

Die MS-DOS-Shell ist jedoch ein MS-DOS-Anwen- 
dungsprogramm, also keine Programmierumgebung wie 
Microsoft Windows oder der MS-OS /2-Presentation Mana- 
ger. Die DOS-Shell bietet deshalb auch kein Anwendungs- 
Programmier-Interface (API) zur Erstellung von Anwen- 
dungsprogrammen. Die MS-DOS-Shell ist darüber hinaus 
kein Ersatz für den COMMAND-Befehlsinterpreter (der 
wie bisher verwendet werden kann), sondern eine optionale 
Erweiterung. 

Auch der SELECT-Befehl für die Installation von MS- 
DOS 4.0 arbeitet nun bildschirmorientiert und führt den 
Anwender Schritt für Schritt durch die Installationsproze- 
dur, die notwendig ist, um MS-DOS 4.0 auf einer Festplatte 
oder einer Diskette zu installieren (Bild 3). SELECT er- 
stellt während der Installation auch die entsprechenden 
CONFIG.SYS- und AUTOEXEC.BAT-Dateien. 
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Bild 2: Mit dem File-System der DOS-Shell können Dateien 
und Verzeichnisse verwaltet werden. 


Viele Verbesserungen 


Unter MS-DOS 4.0 kann der Anwender jetzt Dateien und 
Festplatten-Partitions erzeugen, die größer sind als 32 
Mbyte. Die Version 4.0 ist jedoch noch in der Lage, auf alle 
Partitions und Dateien zuzugreifen, die unter früheren MS- 
DOS-Versionen erstellt worden sind. Der Anwender ist nun 
nicht mehr dazu gezwungen, große Dateien in mehrere 
kleine aufzuteilen, damit eine Speicherung auf der Fest- 
platte möglich ist. Die Festplattendateien können unter MS- 
DOS 4.0 so groß sein wie die jeweilige Festplatten-Kapazi- 
tät. 

Bisherige Gerätetreiber konnten nur logische Sektor- 
nummern bis zu 16 Bit verarbeiten. Unter älteren DOS- 
Versionen war die Aufhebung der 32-Mbyte-Dateigröße- 
Begrenzung nur durch 64-Kbyte-Sektoren möglich, wodurch 
dann aber sehr viel Plattenspeicher verschwendet wird. Die 
neuen, erweiterten Gerätetreiber sind in der Lage, logische 
Sektornummern von 32 Bit Länge zu verarbeiten. Die 
adressierbare maximale Festplattenkapazität beträgt des- 
halb nun 2 Gigabyte. 

Besondere Leistungsverbesserungen konnten beim 
Datei-System erzielt werden. MS-DOS 4.0 verwendet beim 
Zugrif auf die FAT (Dateizuordnungstabelle) verbesserte 
Algorithmen, was sich vor allem beim wahlfreien Zugriff 
auf Dateien bemerkbar machen soll. Die Version 4.0 ent- 
hält auch eine erweiterte und verbesserte Unterstützung für 
das File-Caching. 

Die FASTOPEN-Funktion ist nun in der Lage, die 
Informationen über geöffnete Dateien im Cache zwischen- 
zuspeichern. Mit BUFFERS können mehr Datei-Puffer 
angelegt werden. Ein neuer »Caching-Algorithmus« ver- 
mindert dabei die Zugriffszeit auf Dateien, die in diesen 
Puffern gespeichert sind. Diese Leistungsverbesserungen 
machen sich besonders bei Anwendungen mit umfangrei- 
chen Plattenzugriffen bemerkbar, z.B. Datenbanken. 
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Introduction 


As you view the SELECT displays, you will be asked to make a choice 
or type an entry. you are uncertain about what to choose or type, 
you can accept the predefined choice or press the Fl help key for 
sore information about an item, 


You will be using these keys in the SELECT program: 


To proceed to the next s 

To cancel the current disp ay. 

To move to the next entry field. 

To seroll information one page at a time. 

To move the Scherre bar to "the next item. 

To view the help information. 

To u SELECT. 
F9 To view key assignments while viewing help. 
Left/Right Arrow To scroll data fields horizontally 

to the left or right. 


You can press Enter, Esc and Fl keys when they appear on the display. 


Esc 





Bild 3: Das Installationsprogramm SELECT arbeitet nun 
bildschirmorientiert. 


Neu ist auch die Unterstützung der »Expanded Memory 
Specification« (LIM/EMS 4.0), die von den Firmen Lotus, 
Intel, AST Research und Microsoft entwickelt wurde. Sie 
erlaubt Anwendungsprogrammen und Betriebssystem- 
Erweiterungen auf einen Hauptspeicher zuzugreifen, der 
mit Hilfe von Speichererweiterungskarten über 640 Kbyte 
hinaus erweitert wurde. 

MS-DOS 4.0 kann Speichererweiterungen nach dem 
EMS-4.0-Standard zur Speicherung von DOS-Buffern und 
FASTOPEN-Daten verwenden. Je nach Systemkonfigura- 
tion können die Befehle FASTOPEN und BUFFERS zu 
einem erheblichen Bedarf an Speicherplatz im 640 Kbyte- 
Bereich führen, da jeder DOS-Puffer 512 Byte Speicher 
belegt. Diese Puffer können nun im Expanded Memory 
abgelegt werden, wodurch wieder mehr Speicher für Pro- 
gramme zur Verfügung steht. 

Die Version 4.0 beinhaltet auch einen »LIMulator«, der 
als »Expanded Memory Manager« in einem System mit Ex- 
tended Memory EMS-Speicher simuliert. Der LIMulator 
entspricht ebenfalls den EMS-4.0-Spezifikationen, läuft 
jedoch ausschließlich auf PCs mit 80386-Prozessoren. 


Größerer Speicherbedarf 


MS-DOS 4.0 setzt einen Hauptspeicher von mindestens 256 
Kbyte Kapazität voraus. Der speicherresidente Teil von 
MS-DOS 4.0 ist 10 Kbyte größer als MS-DOS 3.3. 

Da MS-DOS 4.0 konfigurierbar ist, hat der Anwender 
die Wahl, den darüber hinaus gehenden Speicherbedarf für 
das Betriebssystem festzulegen bzw. zu begrenzen. MS- 
DOS 4.0 erreicht oder übertrifft laut Microsoft alle 
wesentlichen Leistungsmerkmale der Version 3.3. Hinsich- 
tlich des veröffentlichten API (Application Programming 
Interface) und der Utilities ist MS-DOS 4.0 kompatibel zu 
MS-DOS 3.3. 


MS-DOS 4.0 





Address Nane Size Type 


BOB4BR 
ERIATT 
Bnd200 


BB25ED System Program 
CON System Device Driver 
AUX System Device Driver 
PRN System Device Driver 
CLOCK$ System Device Driver 
4: - Di System Device Driver 
COMI System Device Driver 
LPTI System Device Driver 
LPT2 System Device Driver 
LPTF System Device Driver 
COM2 System Device Driver 
GOM3 System Device Driver 
GOM4 System Device Driver 


BonaBd 
DOB4BE 
ARRSBR 


BBR7BB IO 


Interrupt Vector 
ROM Communication Area 
XS Communication Area 


DB2CER MSDOS BOBEBR 

BdB59R 10 BEFIT7E 
PLUSDRV BRBASR 
ANSI AA1188 
MOUSE BA266R 
RAMDRIVE BRAATAR 
SMARTDRV BB3B6R 
CACHE2B 
JETSCRPT 


System Program 


System Data 
DEVICE= 
DEVICE= 
DEVICE= 
DEVICE= 
DEVICE= 
DEVICE 
DEVICE= 
FILES= 
FCBS= 
BUFFERS= 
LASTDRIVE= 
STACKS= 

Program 


BIAFIG COMMAND 


BiC56B 
BICSAB 
B1CIBR 
BICASR 
810778 


IBMDOS 
GOMMAND 
NDE 

NDE 

MEM 


-- ETEB -- 
Environment 
Environment 
Progran 

Environnent 


Propran 
B6FSBA -- Free -- 


B1DE1B MEM 
B3RA4D IBMDOS 


655560 bytes total memory 
655360 bytes available 
534496 largest executable program size 


1572864 bytes total extended memory 
36864 bytes available extended nenory 


Bild 4: Der neue Befehl MEM gibt ausführliche Informa- 
tionen über die Speicherbelegung. 


»Normale«e Anwendungsprogramme laufen ohne 
Schwierigkeiten unter MS-DOS 4.0, Probleme treten jedoch 
bei einigen systemnahen Utitities oder Gerätetreibern auf. 
So laufen zum Beispiel die meisten Programme der Norton 
Utilities nicht mehr. Dies liegt zum einen natürlich an den 
Erweiterungen des Dateisystems, zum anderen aber auch 
daran, daß einige systemnahe Utilities undokumentierte 
Funktionsaufrufe, DOS-interne Dateistrukturen oder die 
Interrupte 25h und 26h für den direkten Plattenzugriff 
verwendet haben, die nun geändert wurden. So sollen auch 
Programme und Treiber von Microsoft wie Windows/386 
und der bisherige CD-ROM-Treiber nicht unter MS-DOS 
4.0 laufen. Von diesem Treiber wurde deshalb parallel eine 
neue erweiterte Version angekündigt. 





MS-DOS 4.0 wurde mit der Ankündigung für Mikro- 
computer-Hersteller freigegeben. Die ersten PCs mit der 
neuen MS-DOS-Version sollen voraussichtlich noch in 
diesem Quartal lieferbar sein. Laut Microsoft sind die 
Versionen 4.0 von MS-DOS und IBM-PC-DOS identisch. 


Änderungen und Erweiterungen 


Von den Änderungen und Erweiterungen blieben natürlich 
auch die DOS-Befehle nicht verschont, es handelt sich dabei 
jedoch so gut wie immer um Verbesserungen: 

BUFFERS: Wenn Expanded Memory verwendet wird, 
können bis zu zu 10000 Puffer angegeben werden. Der 
Zugriff darauf wurde durch einen neuen Hash-Algorithmus 
verbessert. Auch können nun mehrere Sektoren gleichzeitig 
gelesen werden. 

INSTALL: Mit diesem Befehl können speicherresidente 
Programme bereits bei der Konfiguration installiert werden. 

REM: Es können jetzt auch in der Konfigurationsdatei 
mit REM Anmerkungen eingefügt werden. 

COMMAND.COM: Der Befehlsprozessor erkennt nun 
auch Programmnamenserweiterungen. Wenn sich drei 
Dateien TEST.BAT, TEST.EXE und TEST.COM in einem 
Verzeichnis befinden, kann jede durch Eingabe mit der 
Erweiterung aufgerufen werden. Bisher wurde die 
Erweiterung ignoriert und die COM-Datei geladen. 

DEL und ERASE: Mit Hilfe des Parameters /P 
(Prompt) kann man anfordern, daß die Namen der zu 
löschenden Dateien angezeigt und sie nur gelöscht werden, 
wenn man dies einzeln bestätigt. Wenn der Befehl DEL *.* 
verwendet wird, wird statt der nichtssagenden Meldung 
»Are you sure?« genau gesagt, daß alle Dateien im 
Verzeichnis gelöscht werden und gefragt, ob dies gewünscht 
wird. 

FASTOPEN: Neben der Unterstützung von Extended 
Memory werden zusätzliche Informationen gespeichert, die 
die Verzeichnissuche beschleunigen und die Zugriffe auf die 
Dateizuordnungstabelle (FAT) verringern. Probleme, die 
sıch bisher beim gleichzeitigen Einsatz von FASTOPEN 
und Plattenreorganisationsprogrammen (OPTIMIZE, 
SPEED DISK) ergeben haben, werden nun vermieden. 

GRAPHICS: Das Hardcopy-Programm wurde wesent- 
lich erweitert. So werden nun alle EGA- und VGA-Grafik- 
Bildschirmmodi unterstützt und es ist über eine ASCI- 
Datei (GRAPHICS.PRO) möglich, das Programm an ver- 
schiedene Drucker anzupassen. 

MEM: Ein neuer Befehl, der Informationen über die 
Speicherbelegung, die ım System befindlichen Treiber und 
speicherresidenten Programme ausgibt (Bild 4). 

MODE: Erweiterungen zur Einstellung der Zeilen- und 
Spaltenzahl auf dem Bildschirm und Wiederholungsrate der 
Tastatur. 

SYS: Das Betriebssystem kann nun auf jede Diskette/ 
Platte übertragen werden, die genug Speicher und Ver- 
zeichniseinträge frei hat. SYS verschiebt Dateien und Ver- 
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niseinträge wenn nötig, um die 
Systemdateien an die richtige Stelle zu 
positionieren. 


TREE: Die Verzeichnisstruktur 
wird nun in eingerücktem Format und 
mit Liniengrafik angezeigt (Bild 5). 


Es werden nun auch endlich die 
Bildschirmadapter EGA, VGA und 
MCGA unterstützt. Das bedeutet, das 
zum Beispiel der Bildschirmtreiber 
ANSILSYS oder Programme wie 
MORE, EDLIN und DIR /P erken- 
nen, wenn auf den neuen Bildschirm- 
adaptern mit mehr als 25 Zeilen gear- 
beitet wird. Auch die neuen Bild- 
schirmmodi können über ANSI- 
Escapesequenzen eingestellt werden. 


Unterm Strich ist MS-DOS 4.0 
eine sinnvolle Weiterentwicklung, 
deren hervorstechendstes Merkmal die 
DOS-Shell ist. Sie wird vor allem 
Benutzern, die nur gelegentlich mit 
dem PC arbeiten oder sıch nıcht auf 
der Bit-Ebene mit der Materie be- 
schäftigen wollen, eine willkommene 


Erleichterung sein. 
(Fortsetzung nächste Seite) 


MANCHE SIND GANZ 
SCHON UBERSPOILERT. 





ECHT SCHNELL DAGEGEN: 


MICROSOFT QUICKBASIC 4.0. 


Eine Schnecke bleibt eine Schnecke - auch 
wenn sie sich durch allerlei Mimikry - Spoi- 
ler, wohlklingende Namen und ähnliches - 
ein rasantes Outfit schneidert. 

Werfen Sie dagegen bei der neuen deutschen 


Ein Compiler, so 
schnell, daß Sie 
wie mit einem 
Interpreter arbei- 
ten. Integrierte 
Entwicklungsum- 
gebung: Compi- 
ler, Editor und 
Debugger in 
einem. Syntax- 
überprüfung bei 
der Eingabe und 
kontextsensitive 
Hilfe. 








Version von Microsoft QuickBASIC 4.0 
mal einen Blick unter die Haube: Da 
gibt es statt Show-Tuning einen vollig 
neu überarbeiteten Compiler. So sensa- 
tionell schnell, daß Sie damit wıe mit 
einem Interpreter arbeiten können: 
Programm ausführen, anhalten zum 
Debuggen und Verändern, einfach weı- 
terlaufen lassen — ohne lästige Warte- 
zeit. Programmanderungen baut Micro- 
soft QuickBASIC 4.0 um die 150.000 
Zeilen pro Minute ein - eine echte 
Revolution! Revolutionar auch die 
automatische Syntaxüberprüfung direkt 


beim Eintippen des Programmcodes. Fehler 
werden sofort angezeigt - die integrierte 
Hilfefunktion liefert dazu schnellstens 
Antworten. 

Und hier das absolut neue Fahrgefühl: Auf- 
rufe der Microsoft Sprachen C 5.0, QuickG, 
FORTRAN 4.0, Makroassembler und 
PASCAL 4.0 werden ebenso unterstützt wie 
die Herkules Graphikkarte und die Intel 
8087/80287 Koprozessoren. 

Also umsteigen, bei uns einsteigen und ab 
geht die Post. Eine Probefahrt wird Sie rest- 
Ios überzeugen. 


Ms/DOS) (me 320/ RM) &B2 : 54 


1 cr ' Be 
r a Ö 
\ N 9 
) 
\ [ - 


— DER SOFTWARE 


ctouUPON 


Bitte senden Sie mir Informationsmaterial zu Microsoft QuickBASIC 4.0. 
Ich nutze Software: Oprwat Dberuflich/Branche ___ 
Mein Rechner: [JMS5-005 DIMS-05/2 DJ Macıntosh 


Bitte senden Sie den Coupon an: Microsoft GmbH » Erdinger Landstraße 2 - BON Aschheim-Dornach 
Absender nicht vergessen. 





VRBDLONEERT 





Die Probleme, die bei einigen 
systemnahen Programmen wegen der 
Erweiterungen des Dateisystems auf- 
treten, werden durch die Vorteile 
(größere Dateien, schnellerer Zugriff) 
mehr als ausgeglichen. 

Günter Jürgensmeier 


Directory PATH listing for 
Volume FestplatteC 
Gi. 





Bild 5: Die Ausgabe von TREE ist 
übersichtlicher geworden. 


Buchbesprechung/Zeichensatztabelle 


Das er mfassende Tabellenwerk für PCs: 


Die PC-Referenz für Programmierer 


In fast jedem Fachgebiet gibt es sie, und sie werden auch 
stark genutzt: Es gibt Tabellenwerke für die Chemie, Phy- 
sik, Mathematik, Maschinenbau und so weiter, nur im Com- 
puterbereich gab es so etwas bisher noch nicht. Das hat sich 
mit dem PC-Sourcebook von Thom Hogan (deutscher Titel: 
Die PC-Referenz für Programmierer) nun geändert. In die- 
sem Buch sind die wesentlichen Fakten über Hard- und 
Systemsoftware des PC-Bereichs in Tabellenform gesam- 
melt. Das Buch läßt sich nur schwer beschreiben, man muß 
es gesehen haben. Deshalb haben wir auf den folgenden 
Seiten einige Beispiele abgedruckt. Dies ist natürlich nur 
ein kleiner Ausschnitt aus der Informationsfülle der über 
500 Seiten. Die wichtigsten Bereiche sind: 


= Allgemeine Tabellen (numerische Konvertierungen, 
Datenformate, Zeichensatztabellen) 

= DOS-Übersichten (DOS-Befehle und ihre Parameter, 
DOS-Utilities, Diskettenstruktur, Dateiaufbau, Spei- 
cherverwendung) 

= DOS-Funktionen (Int 21h, FCB- & PSP-Aufbau, Fehler- 
codes, Gerätetreiber) 

= BIOS-Funktionen (Int 10h inklusive EGA- und VGA- 
Funktionen, Int 11h-Int 1Ah) 

= Weitere Interrupte (Int 24h - Int2Fh, Maus Int 33h, 
LIM/EMS Int 67h) 

= Microsoft Windows (Eingabegeräte, Dateien, Datenfor- 
mate, Windows-Funktionen) 

= PC-Hardware (Tastatur, Bildschirmadapter, Schnittstel- 
len, Uhr) 

= Chips und Register (CPUs, Koprozessoren, Peripherie- 
Chips, Jumper, Controller) 

= Hardwarebeschreibungen (Steckerbelegungen) 


Softwareentwicklern wird damit eine Informationsquelle 
geboten, die viele andere Bücher überflüssig macht. Fast 
alle Informationen lassen sich nun in einem Werk finden. 

Ein interessanter Hinweis noch zum Schluß: Dieses 
Buch ist ein ausgezeichnetes Beispiel für die Qualitäten von 
Microsoft Excel. Alle Tabellen wurde damit erfaßt und auf 
einem Postscript-Drucker ausgegeben. Excel ist also nicht 
nur für Kalkulationstabellen geeignet, sondern ganz all- 
gemein für jede Art von Tabelle, auch wenn darin nicht ge- 
rechnet wird. Besonders wenn man eine Tabelle in Desktop 
Publishing-Qualität ausgedruckt haben möchte, ist Micro- 
soft Excel derzeit unschlagbar. 


Thom Hogan: »The programmer’s PC sourcebook: charts and 
tables for the IBM PC, compatibles, and the MS-DOS Opera- 
ling System, including the new IBM Personal System/2 
computers«, Redmond: Microsoft Press, 1988; 525 Seiten A4; 
ISBN 1-55615-118-7; 824.95. 


Die deutsche Version wird im Oktober ’88 erscheinen: 


Thom Hogan: »Die PC-Referenz für Programmierer«, Mün- 
chen: Microsoft Press im Systhema Verlag, 1988; ca. 525 
Seiten A4; ISBN 3-89390-250-3; ca. DM 69,-. 
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PC- und Windows-Zeichensatztabelle 


Auf der Doppelseite in der Mitte dieses Heftes finden Sie 
eine Übersicht, in der die Zeichen des Standard-PC-Zei- 
chensatzes und ihre Codes dargestellt sind. Diese Tabelle 
soll Programmierern bei Codewandlungen und Umrech- 
nungen behilflich sein und Anwendern die Eingabe von 
Zeichen erleichtern, die nur über die [Alt)-Taste erreichbar 
sind; ein solches Zeichen kann eingegeben werden, indem 
die (Alt)-Taste gedrückt wird und dann (mit gedrückter 
(Alt)-Taste) der dezimale Wert dieses Zeichens auf der 
Zehnertastatur eingegeben wird. 

Im einzelnen werden in der Tabelle für jedes Zeichen 
folgende Angaben gemacht: 


1. Der dezimale Wert (oben links); er ist mit einem D ge- 
kennzeichnet. 


2. Das Zeichen aus dem Windows-Zeichensatz (oben 
rechts). Bei Werten unter 32 werden hier die Control- 
codes angegeben (”A), da diese Zeichen unter Windows 
nicht belegt sind. 


3. Der oktale Wert (Mitte links, gekennzeichnet durch 0); 
besonders für C-Programmierer wichtig. 


4. Der hexadezimale Wert (Mitte rechts, H); hilfreich beim 
Programmieren in Assembler, bei der Arbeit mit De- 
buggern und ganz allgemein bei der systemnahen Pro- 
grammierung. 


5. Der binäre Wert (unten, B); für systemnahe Program- 
mierung (Bit-Verknüpfungen usw.). 


In der ersten schmalen Spalte bei den Werten unter 32 
sind die ASCIH-Namen der Steuerzeichen aufgeführt. 

Mit Hilfe dieser Tabelle läßt sich nun leicht feststellen, 
welches Zeichen welchem dezimalen, oktalen, hexadezi- 
malen oder binären Wert entspricht. 

Da es bei einigen Programmen, aber auch einigen 
Druckern, immer noch zu Problemen mit den Umlauten 
kommt, hier eine Tabelle mit dem Paragraphenzeichen, 
Umlauten und scharfem S und den Codes im DIN- und 
IBM-Zeichensatz: 


$ 
Ä 
Ö 
) 
Ei 
ö 
ü 
B 





Günter Jürgensmeier 


Buchauszug 


__Seiten im Puffer he 
" Ausgabe = Beni [18267 181 [rasen rasne FESTE Jesu 
el EI — In bis 70 Hz 


Max. horiz. Pixel ee  —— 

| Max! vert. Pixel 0 eo er er 

\ = | En 

a a nn 

7 Fernseheranschluß|Nen _ |Ja Nein Nein 

gs AGB Ansehen fe ge N 

n or AGB Anschluß]! Nein |Nin [Nein ha 

ee | _ _— fe U in | 
Foature-Anschluß rn En Nen 

Modulator-Anschluß|Nein ya fein fein 


Hinweise: * BO000 bei 32 K oder B8000 bei 32 K oder AO000 bei 64 K oder AO000 bei 128 K. 
Bei der EGA-Karte wird ein16 K BIOS-Erweiterungsmodul in den Prozessorspeicher 
bei Adresse C0000 gelegt. 

"* Zusammen mit dem monochromen Bildschirm von IBM. 








ZEICHENATTRIBUTE DES MONOCHROMEN BILDSCHIRMADAPTERS ({MDA) 
Bitnummer 


(z[6][5]#[3]2T 10T Funktion T ae wer 
Ai [I] | fer _ ___jpenlahtpiden, I-banien 


BE 


ER normal, 1=erhöhte Intensi 
X |Vordergrund 000 = schwarzes Zeichen 
111 = weißes Zeichen 


ZEICHENATTRIBUTE VON CGA, EGA UND VGA 





Bitnummer | \ j I \ 
716]51413|2|1]o| Funktion _ | erlaubte Werte 
Meigtz 1 [| | [Blinken ö=nicht blinken, 1=blinken _ 


| Hintergrund 000=schwarz 
| 001=blau 
| 010=grün 
101 1=kobaltblau 
100=röot 
| 1101=violett 
n 
| 


Hinweis:  Unsichtbare Zeichen erhält man, wenn man Zeichen auf einen 
Hintergrund der gleichen Farbe stellt. (z.B. weiß auf weiß). 


X en 00 2 mit Intensität: dunkelgrau 
001=b mit Intensität: hellblau 
| 





mit Intensität: hellgrün 
101 1=kobaltblau mit Intensität: hellkobaltblau 
100=rot mit Intensität: hellrot 
101=violett mit Intensität: hellviolett 
110=braun mit Intensität: gelb 
111=grau mit Intensität: weiß 


41%] [| [inensitat ___| 
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sjita ı ELIRYATEN 


ÜBERSICHT ÜBER DIE BILDSCHIRMMODI 











Einzeheiten der BIOS-Modi Unterstützt von Adapter 

__ 0 | Tex] 2 | 0 Bono is | I x I x I x 1x 
1 | Text | 25 | 40 EFEBES3ER 
2 | Text | 25 X I x 1x 
3 | Text | 25 IX I 3%: 1% | 
__4 [Grafik] 25 | [I x I x | 
5 _ [Grafik] 25 | IR I RN 
6 [Grafik] 25 X | x 1x 
7 | Text| 35 EZRBEH 
13 _ | Grafik | 25 | _& I 1% 
__14 | Grafik | 25 | X | 1x 
__15__| Grafik | 25 1 
_16_ |Grafik| 25 & I 1% 
_17 | Grafik | 30 | ER ER 
18 | Grafik | 30 | 1 1% | 
__19 | Grafik. 1x 1x | 





Hinweise: " Die EGA-Werte gehen von 256K RAM aus. 
* Die Modi 8 bis 12 werden nur vom PCJr verwendet. 
* 720x400 bei VGA 
HÄUFIGE STRINGFORMATE 
DOS-Befehlszeile 
0 1 127 
DOS-Stringanzeige 
(Int 21, Funktiong) | Sting 1 $ 
0 Länge+1 
AScız | Sin jo 
10) Länge+1 
ce [|_ Sig jo 
0 Länge+1 
Pasca® |Stäne| 24 Sing 
0 2 Länge+2 
BASICA*”* 
(Microsoft BASIC) [Länge | Zeiger | > 
0 1 2 Zeiger Zeiger + Länge 
Hinweise: * Nicht alle C- und Pascal-Compiler verwenden exakt diese Formate, doch dies 
ist der jeweils anerkannte Standard. 
"* In BASICA werden der String und die Informationen darüber im Speicher nicht 
hintereinander gespeichert. 


WERTEBEREICHE VERSCHIEDENER 8087-DATENFORMATE 


kleinster möglicher Wert größter möglicher Wert 












18087 Pckd DcimalöÖ | oe —— K1oria)-t 
1.67 x 10*308 


0 1,67x 101308 
8087 Temporary Real san aaa2l 9 1.2x1044932 
JEEE Floating Point 4.19 x 10*-30 1.67 x 10"308 
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Buchauszug 


VERZEICHNISEINTRÄGE 


5% —IeBne— (Oaumune" — —— jgorzenen | 
| ee 

Bit codes: Bit 0 = nur Lesen 
Bit 1 = versteckt 
Bit 2 = System 
Bit 3 = Datenträgername 
Bit 4 = Verzeichnis 
Bit 5 = Archivierung 
Bit & = nicht verwendet 
Bit 7 = nicht verwendet 


2 BL 10 Byte RESERVIERT _ _ ET en 
oem ErE aadstek 
Zeit - a Sa | 





Hinweise: - Dateiname und Erweiterung werden nicht durch einen Punkt getrennt. 

" Niederwertiges Byte zuerst 

** Das erste Byte des Dateinamens kennzeichnet den Status eines Verzeichniseintrags: 
00H = Eintrag/Name wurde nie verwendet 
05H = das erste Zeichen des Namens ist eigentlich ESH (Sigma) 
ESH = Eintrag wurde verwendet, Datei wurde jedoch gelöscht 
2EH = Eintrag ist ein Verzeichnis (wenn das zweite Byte auch 2EH ist, enthält das 
Clusterfeld die Clusternummer des übergeordneten Verzeichnis) 


DATEIATTRIBUTBYTE 


Bitnummer 


(zJe]5T#[s[2[ Jo Bedeutungen t — [| ___Bedeutungweno 
ee en 





x|xI I FT 1-1 IReserviert | RESERVIERT 

Version: DOS 1.x verwendet nur die Bits 0-3 

Hinweise: * Die Bits 3 und 4 schließen sich aus; es kann keines, das eine oder das andere gesetzt sein, 
doch nicht beide. 


: Nur bei einer Datei (im Stammverzeichnis) darf Bit 3 gesetzt sein. 


TYPISCHE REGISTERVERWENDUNG UNTER DOS 


Anmerkun ing en 


—PJ en 7 
_BP__|Basisregister Stape 
| 08 | Datensegmen U [e wird normalerweise mit DX verwendet 
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jeuınof waJsÄg J0S0.Dı 9% 


8861 Pgomo/aquaıdas 





Steuer- 
zeichen 


PC-Zeichen 


oktal 


Controlcode oder 
Windows-Zeichen 


hexadezimal 








N 
U 
L 
S 
0 
H 
5 
T 
X 
E 
T 
X 
E 
0 
T 
A 
C 
K 
B 
E 
L 
B 
S 
H 
T 
L 
F 
V 
T 
F 
F 
C 
R 
S 
0 
S 
I 
R 


0000 
0000 00H 
000000005 


001 A 
001o Olr 
00000001s 


0022 *B 
0020 02u 
00000010» 


003 C 
0030 034 
000000118 


00% *D 
0040 O4 
000001005 


005 *E 
0050 05H 
00000101s 


0066 *F 
0060 06H 
00000110s 


007 *7G 
0070 074 
00000111s 


008 "H 
0100 084 
000010005 


00% I 
Ollo 09 
00001001s 


0100 U) 
0120 OAH 
000010108 


Ollo *K 
0130 OB 
00001011s 


012 AL 
0140 OCH 
00001100» 


0135 M 
0150 ODk 
00001101s 


014 N 
0160 OEH 
00001110» 


015 0 
0170 OFH 
00001111s 


01l&n °P 


} > n?NA 1Nu 


0320 
0400 20H 
001000008 


0330 ! 
04lo 21H 
00100001s 


0340 " 
0420 224 
00100010s 


0350 5 
0430 23# 
00100011s 


036 $ 
0440 24u 
001001008 


037% % 
0450 25H 
00100101s 


0380 & 
0460 26H 
001001108 


039 ' 
0470 27% 
00100111» 


040  ( 
0500 28H 
001010005 


04 ) 
05lo 29 
00101001s 


0420 * 
0520 2Au 
00101010s 


045 + 
0530 2Bh 
00101011s 


0440 x 
0540 2Ch 
00101100s 


0450 - 
0550 2Dh 
00101101s 


0460 
0560 ZEH 
00101110s 


0470 / 
0570 2Fh 
00101111s 


ni» Ip 





064 0 
1000 404 
010000005 


0655 A 
10lo 4lu 
01000001s 


066  B 
1020 424 
010000105 


06% C 
1030 434 
01000011s 


068 D 
1040 444 
010001005 


069% E 
1050 454 
01000101s 


0700 F 
1060 46# 
01000110» 


0b 6 
1070 474 
01000111s 


0720 H 
1100 48 
01001000» 


0730 I 
1l1lo 49 
010010015 


074 U 
1120 4An 
010010105 


0750 K 
1130 4Bu 
01001011s 


0760 L 
1140 4Cu 
010011008 


077% M 
1150 4Du 
01001101s 


0780 N 
1160 4EH 
01001110s 


07% 0 
1170 4Fh 
01001111s 


09  ° 
1400 60 
011000008 


0970 a 
14lo 61 
011000015 


098  b 
1420 624 
011000108 


09% c 
1430 63n 
01100011s 


1000 d 
1440 64u 
01100100» 


101o e 
1450 . 65# 
01100101s 


1020 f 
1460 66H 
01100110s 


10%» g 
1470 674 
011001115 


1040 h 
1500 68 
01101000s 


1050 i 
15lo 69 
011010015 


106 j 
1520 6An 
011010105 


1070 k 
1530 6Bh 
01101011s 


1080 ] 
1540 6CH 
01101100» 


10% m 
1550 6Dh 
01101101s 


10 n 
1560 GEH 
01101110s 


11lo ) 
1570 6Fh 
01101111s 





080  P 1120 


1445 5 
2200 90H 
10010000» 


1450 ' 
22lo 91n 
10010001s 


1460 
2220 924 
10010010s 


147 u 
2230 934 
10010011s 


1480 s 
2240 94u 
10010100» 


14» = 
2250 95H 
10010101s 


1500 a 
2260 96H 
10010110s 


151o a 
2270 974 
10010111e 


1520 a 
2300 984 
100110008 


1530 u 
23lo 99 
10011001s 


1540 u 
2320 9A 
100110108 


1550 D 
2330 9Bh 
10011011a 


1560 2 
2340 ICh 
10011100s 


1570 u 
2350 9Dh 
10011101s 


1580 u 
2360 9EH 
100111108 


159% u 
2370 9Fu 
10011111s 


1280 a 


INN on. 





_ 


1760 . 
2600 BOn 
10110000» 


1770 + 
26lo Blu 
10110001s 


1780 2 
2620 B2u 
10110010s 


17% 3 
2630 B3n 
10110011s 


1800 : 
2640 B4Hn 
101101008 


18lb u 
2650 B5H 
10110101s 


182 1 
2660 B6n 
10110110s 


1830 
2670 B7h 
10110111s 


18h , 
2700 BSH 
101110005 


1850 1 
2710 B9h 
10111001s 


186 2° 
2720 BAn 
10111010s 


1870 » 
2730 BBu 
10111011s 


188 % 
2740 BC 
101141008 


18 % 
2750 BDh 
10111101s 


190 % 
2760 BEH 
101111108 


1910 & 
2770 BFu 
10111111s 


1600 


AN 





208 DB 
3200 DOH 
110100008 


209 N 
32lo Din 
110100015 


21n © 
3220 D2H 
110100108 


2ilb Ö 
3230 D3n 
11010011s 


21% Ö 
3240 D4u 
110101008 


21» Ö 
3250 D5# 
11010101s 


21% Ö 
3260 D6n 
11010110s 


2150 ® 
3270 D7u 
11010111s 


2lı 8 
3300 D8h 
110110008 


21n U 
331o D9 
110110015 


21 0 
3320 DAu 
11011010s 


21% 0 
3330 DBn 
11011011s 


20 U 
3340 DCH 
110111008 


221 Y 
3350 DDh 
11011101a 


222 bb 
3360 DEHu 
110111108 


223»  B 
3370 DF# 
11011111s 


| |19% 


2400 Ö 
3600 FOH 
11110000s 


2410 N 
36lo Fir 
11110001s 


242 Ö 
3620 F2u 
11110010s 


2430 ö 
3630 F3h 
11110011s 


2440 ö 
3640 Fäu 
111101008 


2450 ö 
3650 F5H 
11110101a 


24 Ö 
3660 F6n 
111101108 


2470 B 
3670 F7u 
11110111s 


248 0 
3700 F&u 
111110008 


24% ü 
37lo F9u 
11111001s 


250 ü 
3720 FAH 
111110108 


2510 ü 
3730 FBh 
11111011s 


252 Üü 
3740 FCh 
111111008 


253 5 
3750 FD 
11111101s 


2540 b 
3760 FEH 
11111110» 


255 
3770 FFu 
11111111s 





2240 ä 


Jan. rn 
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080  P 122 p 









































D 016 AP 0 0 

Ki 0200 10H () 0600 30% P 1200 504 1600 704 
000100005 001100005 01010000» 011100005 
01700 4 1 08 q 11 q 
0210 In O6lo 31H 1210 51h 1610 7in 
000100018 | 1001100015 010100015 011100015 
0180 “R 5% 2Imlon R ih r 
0220 124 ? 0620 324 1220 52% 1620 724 
000100108 001100108 | * *|01010010s 011100106 


650 3| 
0630 33% 
00110011s. 


05 4 
0640 34m 
001101008 


01% X [08% s 
1230 53# 


01010011s 


0846  T 
| 1240 544 
| 010101008 


085 U 
1250 554 
01010101a 


0860 NV 
1260 56# 
01010110s 


1 5 
1630 73H 
01110011» 


021 U lo» 5 
0250 15H h 10650 35% 
000101018 | 


8 | 001101018 
n 022 Av 


0230 13% 
| 000100118 


0200 ”T 
0240 14u 
00010100s 













116n t 
1640 744 
011101008 


117 u 
1650 75H 
01110101s 


1180 1" 
1660 76H 












054 6 
0260 16H 


0660 36H 
000101108 001101108 



















































=] #81 o7lsonlseo] znl2>5]lssnle=olss21s55 1858 Rs =55 Ir 
DJ 2[e—I [N |< |x |zZ|<|e|a|lo [Ss |o|o 


0230 W 05 7 087% MW 10 wi 
0270 17H / 0670 374 1270 574 1670 77h 
00010111s 00110111s 010101115 011101118 | 
0246 X 0566 8 |1z losen x 120 x 
0300 184 0700 384 1300 58 1700 784 
000110008 001110008 010110008. 011110008 
0250 NY 05% 9 08%  Y 12lo y 
0310 194 0710 39 1310 59 | 1710 79 | 
000110018 | 001110018 | [010110018 [7 [011110018 
026 77 05: 000 2 2A 2 
0320 1A 0720 3An 1320 5AH 1720 7An 
000110108 001110105 010110105 01111010s 
02% X 5% ;:IMlom L 
0330 1Bh 0730 3Bh 1330 5Bu 
00011011s 00111011» 01011011s '01111011s 
| 0606 <= I\ log \ 120 | 
< |07% 364 1340 5CH 1740 7Ch 
| 001111008 010111005 011111008 
06 = 09% ] 125 |} 
0750 30H 1350 50% 1750 70h 
001111018 010111015 011111018 
| 06 > Ion 125 ” 
1E" | > [0760 364 1360 SE» 1760 7En 
000111108 001111108 010111108 O1111110s 
| | p |o60 2? 0 | 2n m 
0770 3Fh 1370 5FH 1770 7Fn| 
| ® [00111111s [010111118 O1111111s 


011101108 














1600 19% Al 22h Ää 


1280 u 

2000 80H 2400 A0h 3000 COH 3400 EOH 
100000008 101000008 110000005 | ” "| 11100000: 
19% Ä 









[od | m] mo || w:o] mie: | 











2% u 
20lo 81n 
10000001s 


1300 u 
2020 82H 
100000108 


13bo a. 
2030 83» 
10000011s 


1305 = 
204 84 


161o i 
24lo Alu 
10100001s 


167 € 
24720 Au 
10100010s | 


16: £| 
2430 A3u 
10100011s 
16h =| 
2440 Ad 


2250 ä 
34lo Elhk 
11100001s 


22 ä 
3420 E2h 
11100010» 


22h Ää 
3430 E34 
11100011a 
228 ä 
3440 E4u 











[3010 Cin 
| 110000015 






















3030 (34 
| 110000118 | 











13040 C4u 













100001015 


134 u 
2060 B6n 
10000110s 


135 u 
2070 874 
10000111s 


1360 = 
2100 884 
100010008 


| 11000101s 


100001008 10100100: | | 111001008 
13h u 169  % | | 2% ä 
2050 85H 2450 A5H 1305 C5H 3450 ES5H 






10100101s 


1660 | 
2460 Ab | ChH 
101001108 | 11000110s h 


1690 8 | 
2470 A7u| 
10100111 | 


1680 
2500 A8n 
101010008 | 


1370 = Ip ©/| 20 E 
21lo 8 251lo A9n |3llo CH 
100010018 10101001a 110010018 


138 = 170 all 200 E 
2l?o 8An ee A i31l20 CAr 
| 10001010% 10101010s 110010108 


130 = 17. 200 € 
2130 8Bh 2536 ABu [3130 CBr 
100010118 101010113 | If | 120010115 | 


140 a 172% - “ 200 1 









11100101s 


23 ® 
3460 E6n 
11100110s 


23lb g 
3470 E7H 
11100111s 



















3100 Bu 
110010008 | 


E94 
11101001: 


KSRIEIESEISEIENEN 






















3520 EAH 
1111010108 

























2140 8Ch 2540 ACh 3140 CCH | 
10101100 | |] | 11001100; 


7 - 1205 1 
2550 ADk 3150 CDk 
10101101s 11001101a 


JL 2000 1 


2560 AEH 3160 CEH 
101011108 | I] | 110011105 


75 7 BR 20n ji 


2570 Ak 13170 CFh 
10101111s 11001111s ie 






100011008 


1410 u 
2150 8Du 
10001101s 





-— 






—ı) 







1740 & 
BEH 
10001110s 






EFH 
11101111s 


=] eier I 





ITdBLIEYAIFL 


DIE SPEICHERVERWENDUNG nn BIOS Lee _ = 















Wort 
[4002 T_ Wo [Besiadresss com — 11T 17 
40:04 | Wort |[Basisadresse com —7L9m—m3— I IT 
I 4008 | Wer _ Basisadı EI 5 
agne wog _ Basisadresse LPTI 









Basisadresse LPT2_ 
65C [| Won | Basisadresse LPT3 CE 
| 40:0E | Wort |[Basisadresse LPT4 #4 


Byte  |IInstallierte Hardware 1 





Tara Floppy- -Laufwerke (beginnt mit 0) 
Videomodus (01=40x25 Farbe, 10=80x25 Farbe, 11=80x25 mono) 
IRESERVIERT (alte PC und PCJr: Bits 2-3 geben inst. Speicher an) 
Zeigegerät installiert (nur PS/2) 

'Num. Koprozessor installiert (nicht beim PCjr oder Convertible) 
|Floppylaufwerke installiert 
Anzahl Druckeradapter 
Internes Modem (nur Convertible) 
Joystick installiert 
Anzahl RS- 232- „Adapter 
























Installierte Hardware 2 












= Hr 
In BEE 
= x 






Alt-Taste gedrückt 
Ctrl-Taste gedrückt 

Linke Shift-Taste gedrückt 
|Rechte Shift-Taste gedrückt 
Taste Einfügen gedrückt 
Taste Caps-Lock gedrückt 
Taste Num-Lock gedrückt 
Taste Scroll-Lock gedrückt 
Pausenmodus aktiv 






Tastatursteuerung 2 











Taste Systemanfrage gedrückt 
x Linke Alt-Taste gedrückt 
Rechte Alt-Taste gedrückt 
“ 1A =: Zeiger auf Start de a” es auf das erste Zeichen im Tastaturpuffer 
[Zeiger auf Ende des Tastaturpu! w igt auf das letzte Zeichen im Tastaturpuffer 





ee 1 one Fran IH 


Byte Status Nachjustierung der Floppy I Iinterruptflag 
x x RESERVIERT 
Motorstatus der Floppy 4 1 
Status Laufwerk 1 Motor AN 
X |Status Laufwerk 0 Motor AN 


Laufwerk 3 nachjustieren 
Laufwerk 2 nachjustieren 
Laufwerk 1 nachjustieren 
DEE DE DE DE 
Laufwerk nicht bereit 
Fehlerhafte Positionierung 
| Allgemeiner Controllerfehler 
CRC-Fehler beim Lesen der Diskette 

















Schreib-/Leseoperation 
RESERVIERT 
Ausgewähltes Laufwerk (Bitwert = Laufwerk) 
Status Laufwerk 3 Motor AN 

Status Laufwerk 2 Motor AN 







DMA-Überlauf bei der Operation 
X Geforderter Sektor nicht gefunden 
Adreßmarke nicht gefunden 
X | Ungültige Laufwerkparameter 
‚Kein Fehler 
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DIE m DES BIOS BLUE 









1007 Doppowonlzage 
"1080 |Doppe me 
Zei Toy [ta alias 














wo | Byte | 
40:77 | Byte | | 
| 40:78 | Byte | / 


fe) 
8 
ler) 
£D 
5 
[= 
ıi 
® 
= 
| 
=) 
= 
KE 
[6%] 










4025 | Wor |Zeichnhöhe ByisZichen 
rose | pe Bildschirmsteuerstatus 2 
080 | Won |nesenmen_[ 


20:88 Byte |Mediasteuerung 








Laufwerk-Datenrate” (AT, XT nach 10.1.85, PS/2) 
Doppelstepping notwendig (AT, XT nach 10.1.85, PS/2) 
Medium eingerichtet (AT, XT nach 10.1.85, PS/2) 
RESERVIERT 

Laufwerk-/Mediumstatus"* (AT, XT nach 1.10.85, PS/2) 
Laufwerk-Datenrate* (AT, XT nach 10.1.85, PS/2) 
|Doppelstepping notwendig (AT, XT nach 10.1.85, PS/2) 





Medium eingerichtet (AT, XT nach 10.1.85, PS/2) 
RESERVIERT 
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DIE SPEICHERVERWENDUNG DES BIOS _Bitnummern 
(Adresse ange [| Beschruung  Trlel5[als 
BEE EEE EEE 
„4082 | Won IRESERVERR______ _ I II 1 
se Bye — Ssas 





: 2 
| mel Aktueller Zylinder Laufwerk 1 BEE= 


Byte |Modusstaus Tastatur 
|Letztes Zeichen war erstes ID-Zeichen 


Num-Lock erzwingen wenn ID gelesen und KBX 
Tastatur mit 101/102 Tasten installiert 

rechte Alt-Taste gedrückt 

rechte Ctri-Taste gedrückt 

Letzter Code war EO, versteckter Code 

X |Letzter Code war E1, versteckte Code 


Byte ILED-Flags Tastatur Fehlerflag Tastaturübertragung 
| Aktualisierung Modusanzeige 
Empfangsflag zurücksenden 
Empfangsbestätigung erhalten 
RESVERVIERT (muß 0 sein) 
X X ]Statusbit LED 


me | Wer | Ike t auf Warteroutine a | 
Fear nen gm uam 


| Jin Mikrosekunden 


EA  munnnanen inMikrosekunden 


40:A0 Byte |Flag warten aktiv verstrichene Wartezeit | 1 | 
XIXIXIX|IX] IRESERVIERT | 


X |Int 15H Funktion 86H (Wai 


40A1 | 7Bye_|RESERVIERT_ — re 
[40:28 |Doppetwort[Zeiger aut Bidschirmparametertab. | | | [| [| [ InurEGAungpsm 





















|_49:B0_|Doppeiwort _TI-1- 1-1 IhuresA und ps72 


m 
[11] Tu EGA und 





I-22:34_[Doppehwent , DE 

[1082 [bessern Senmngunge — IILITIIIT nur PS/2 (nich Modeil30 

oo | BBye_ [RESERVIERT (1 1 | | | I | [wirdnur setz 

40:0 | 64Byte BEsEVIERn 


ee HH — 


Version: Das erweiterte BIOS von PS/2 verwendet Speicher im oberen Bereich als erweiterten BIOS-Datenbereich. 
Hinweis: " Laufwerksdaten: 00 = 500 KB/Sek., 01 = 300 KB/Sek., 10 = 250 KB/Sek., 11 = RESERVIERT 
" Werte des Laufwerksmediastatus derzeit im IBM-BIOS-Handbuch nicht dokumentiert 


AUFBAU DES PROGRAMMSEGMENTPRÄFIX 


€ mer 
En 
a 
_50(80) | wor |[coeıH [nz Dos 
_52(82) | Byte (BHO a 
ee se | RESERVIERT 

a ae ee Senna een — 
ac] om [Tu Er Eehlecslenn 


|_81 129) _ |Befehlszeilenparameter beginnt mit ae endet mit CR 





Hinweis: Die einzigen sinnvollen Informationen in den FCBs sind Laufwerksnummer und Dateiname. 
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ill going strong: 


Geschichte und Aufbau von MS-DOS 


Nach acht Jahren und zahlreichen Versionen ist 
MS-DOS in der Version 4.0 nun so komfortabel 
und umfangreich wie nie zuvor. Alterserschei- 
nungen sind ihm noch nicht anzusehen und es 
wird ihm immer noch eine glänzende Zukunft 
vorausgesagt. Anlaß genug, um uns einmal aus- 
führlich mit der Entwicklungsgeschichte und 
dem Aufbau von MS-DOS zu beschäftigen. 


Angefangen hatte alles eigentlich schon im Oktober 1980. 
Damals kamen die Manager von IBM auf Microsoft zu und 
fragten, ob sie ihnen nicht ein Betriebssystem für ihren in 
der Entwicklung befindlichen 16-Bit-Mikrocomputer pro- 
grammieren könnten. Vorher hatten Sie bei Digital Re- 
search nachgefragt, dem Entwickler des damals wichtigsten 
Mikrocomputer-Betriebssystems CP/M. Der Geschäftsfüh- 
rer von Digital Research, Gary Kildall, war bei einem ge- 
planten Treffen jedoch verhindert, die IBM-Manager fühl- 
ten sich vor den Kopf gestoßen und gingen zu Microsoft, die 
damals vor allem wegen ihres BASIC-Interpreters bekannt 
waren. 

Geschäftsführer von Microsoft war damals, genau wie 
heute, William H. Gates III, oder kurz Bill Gates, der zu- 
sammen mit seinem Partner Paul Allen Microsoft BASIC 
entwickelt und erfolgreich gemacht hatte. Bill Gates, der 
eine in der Mikrocomputerszene seltene Mischung aus 
profundem Computerfachwissen und gutem Geschäftssinn 
besitzt, witterte die Chance seines Lebens und sagte ohne 
zu zögern zu. Er besaß zwar zu diesem Zeitpunkt kein Be- 
triebssystem, doch war das für ihn kein Hinderungsgrund. 
Er kannte eine kleine Firma mit dem Namen Seattle Com- 
puter Products, deren Mitarbeiter Tim Paterson ein ein- 
faches 16-Bit-Betriebssystem für den Intel 8086 entwickelt 
hatte. Paterson nannte das Betriebssystem ursprünglich 
ODOS, was für »Quick’n Dirty Operating System«, also 
etwa »Das schnell und unsauber programmierte Betriebs- 
system«, stand. Später taufte er es jedoch auf den seriöseren 
Namen 86-DOS um. Bill Gates kaufte nun kurzerhand für 
50000 Dollar die Rechte an diesem Betriebssystem und 
machte es zur Grundlage von MS-DOS. Im November 1980 
unterschrieb IBM den Entwicklungsvertrag mit Microsoft, 
im Februar 1981 hatte Microsoft einen Prototypen von MS- 
DOS auf einem Prototypen des IBM-PC zum Laufen ge- 
bracht. In den folgenden sechs Monaten bis zur Ankündi- 
gung des IBM-PC wurde noch weiter daran gefeilt, so daß 
es stabil und für den Büroalltag geeignet war. 


Die Versionen 


Tim Paterson, der ab Mai 1981 bei Microsoft beschäftigt 
war, hatte 86-DOS auch unter dem Gesichtspunkt entwik- 
kelt, daß die Umsetzung von CP/M-Programmen, die zu- 
meist in 8080-Assembler geschrieben waren, einfach sein 
sollte. 


Version Datum Beschreibung 

86-DOS 1980 Originalversion von 
Seattle Computer Pro- 
ducts 


PC-DOS 1.0 August 1981 PC-DOS für den Origi- 
nal-PC, einseitige Dis- 


ketten 

PC-DOS 1.1 Mai 1982 doppelseitige 
Disketten 

MS-DOS 125 198 erste OEM-Version 


MS-DOS & 
PC-DOS 2.0 März 1983 PC XT mit Festplatte, 
hierarchisches Datei- 


system 

PC-DOS 2.1 Oktober 1983 für IBM PCir und trag- 
baren PC 

MS-DOS 2.1 1983 Unterstützung interna- 


tionaler Belange 
MS-DOS & 
PC-DOS 3.0 August 1984 für PC AT mit High- 
Density-Diskettenlauf- 
werken und größeren 


Festplatten 

MS-DOS & 

PC-DOS 3.1 März 1985 Netzwerkunterstützung 

MS-DOS & 

PC-DOS 3.2 1986 Unterstützung von 3 1/2- 
Zoll-Disketten 

MS-DOS & 

PC-DOS 3.3 _ April 1987 PS/2-Unterstützung, 
Aufteilung von Festplat- 
ten mit über 32 Mbyte. 

MS-DOS & 

PC-DOS 4.0 Juli 1988 bildschirmorientierte Be- 
nutzerschnittstelle, EMS- 
Unterstützung 


Tabelle 1: Die wichtigsten Versionen von MS-DOS. 


Deshalb wurden die meisten Funktionen und Strukturen 
(z.B. Dateisteuerblöcke - FCBs) übernommen, damit 
CP/M-Programme von einem einfachen Umsetzungspro- 
gramm in 8086-Code umgesetzt werden konnten. So war die 
erste Version von MS-DOS eigentlich nicht viel mehr als 
ein CP/M für 8086-Prozessoren. 

MS-DOS ist jedoch im Laufe der Zeit mehrmals geän- 
dert und stark erweitert worden (es existieren sogar meh- 
rere Versionen, die nie offiziell zu kaufen waren). Auch 
wenn es zum Teil um Fehlerkorrekturen ging, waren neue 
Versionen meistens mit Hardwareankündigungen von IBM 
verbunden. In Tabelle 1 sind die wichtigsten DOS-Versio- 
nen aufgeführt. 

Jede DOS-Version wurde durch die notwendigen Er- 
weiterungen und Verbesserungen natürlich auch größer. 
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Die Version 1.0 kam noch mit 16 Kbyte Speicher aus, was 
auch notwendig war, da der erste IBM-PC nur mit 64 Kbyte 
Speicher ausgestattet war. Die Version 2 benötigte bereits 
24 Kbyte und für ernsthafte Programme war deshalb schon 
ein Speicherausbau von 128 Kbyte Voraussetzung, 256 
Kbyte waren jetzt ein Traumausbau. In der Version 3 benö- 
tigt DOS 36 Kbyte und oft sogar mehr, wenn weitere Gerä- 
tetreiber oder Netzwerkunterstützung geladen werden. Ein 
Standard-PC mit weniger als 512 Kbyte wurde nun fast 
schon belächelt. Mit der Version 4.0 hat sich der Speicher- 
bedarf noch einmal um 10 Kbyte erhöht, sie verbessert die 
Speichersituation jedoch insofern, daß sie die Verwendung 
von Speicher nach dem LIM/EMS-Standard für Puffer er- 
laubt, so daß der Programmspeicher von MS-DOS, der auf 
PCs auf 640 Kbyte beschränkt ist, wieder ein wenig entlastet 
wird. 


Die Versionen im Detail 


1.0: Die Originalversion für IBM-PCs, in den wesentlichen 
Teilen dem damaligen Betriebssystemstandard für 8-Bit- 
Computer, CP/M, sehr ähnlich. Zu den Verbesserungen 
gegenüber CP/M gehörte vor allem eine verbessertes 
Dateisystem, das den Dateizugriff beschleunigte und es dem 
Benutzer ermöglichte, auch ohne umständliche Anmeldung 
(mount oder Control-C bei anderen Systemen) Disketten zu 
wechseln. Auch können beim Start automatisch Befehle 
ausgeführt werden, die in einer Datei mit dem Namen 
AUTOEXEC.BAT stehen. Da auf 8086-Computern Pro- 
gramme größer als 64 Kbyte sein können (die Grenze bei 8- 
Bit-Computern), wurde mit EXE-Dateien ein neues Pro- 
grammformat angeboten, in dem auch größere Programme 
relokatierbar (positionsunabhängig) gespeichert werden 
können. 

Laut Bill Gates entsprach das Betriebssystem in dieser 
Version noch nicht seinen Vorstellungen: »Im Grunde 
wollten wir eigentlich eines schreiben, das mehr wie die 
Version 2 aussehen sollte, mit hierarchischem Dateisystem 
und allem ...«. Doch die Entwicklungszeit reichte dafür 
nicht, so daß sich Microsoft auf eine lauffähige Untermenge 
beschränken mußte. Insgesamt bestand die Version 1.0 aus 
4000 Zeilen Assemblercode; der speicherresidente Teil war 
im lauffähigen Zustand 8 Kbyte groß. Der Betriebssystem- 
kern bestand schon damals aus drei Programmen: 


IBMBIO.COM bzw. 10.SYS, die Schnittstelle zum BIOS mit 
Zeichen-Ein-/Ausgabe und Diskettenzugriffen. 
IBMDOS.COM bzw. MSDOS.SYS, der eigentliche Kern des 
Betriebssystems mit Programmierschnittstelle. 
COMMAND.COM, der Befehlsprozessor, oder wie es heute 
schöner heißt, die »Benutzerschnittstelle«, also der Teil von 
DOS, mit dem es der Benutzer meistens zu tun hat, die von 
vielen wenig geschätzte »Eingabeaufforderung«. 
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Die Version 1.0 wurde nur von IBM angeboten und all- 
gemein PC-DOS genannt. Microsoft hatte jedoch schon 
vorgesorgt und eine hardwareunabhängige interne Struktur 
entwickelt, die die Anpassung auf andere System leicht 
machen sollte. 

Die Version 1.0 unterstützte nur einseitige Disketten mit 
160 Kbyte Speicherkapazität, an Festplatten war zu dieser 
Zeit wegen der hohen Preise noch nıcht zu denken. 


1.1/1.25: In dieser Version wurde MS-DOS nun auch von 
anderen Herstellern wie Compaq und Zenith angeboten. 
Bei IBM war die Versionsmnummer 1.1, bei Microsoft und 
seinen OEMs 1.25. Es wurden einige Fehler ausgebessert, 
die Geräteunabhängigkeit verbessert und doppelseitige Dis- 
ketten mit 320 Kbyte unterstützt. In Deutschland war der 
wichtigste Computer, auf dem diese Version lief, der von 
vielen immer noch geschätzte Sirius 1, der jedoch von 
Anfang an auf einer 5 1/4-Zoll-Diskette 600 Kbyte und 
später sogar 1,2 Mbyte speicherte. Dem Erfolg des Sirius 1 
und der engen Zusammenarbeit seiner Entwicklungsmann- 
schaft mit Microsoft ist es zu verdanken, daß MS-DOS auch 
in Deutschland schnell der Standard wurde, denn der IBM- 
PC wurde zu diesem Zeitpunkt noch nicht in Deutschland 
verkauft. 


2.0: Die Version 2.0 war der gewaltigste Schritt in der Ent- 
wicklung von MS-DOS und brachte es in die Form, die ur- 
sprünglich geplant war. Sie brachte die Unterstützung von 
Festplatten, wodurch auch ein neues Dateisystem notwendig 
wurde. Die wichtigste Erweiterung dieser Version war des- 
halb eine hierarchische Verzeichnisstruktur, die von Unix 
bzw. Xenix übernommen wurde. Um dem PC als offenes 
System gerecht zu werden, konnten nun beim Start Geräte- 
treiber installiert werden, die sogar eingebaute Treiber er- 
setzen durften. Doch wurden auch noch viele andere Er- 
weiterungen vorgenommen, die DOS endlich zu einem 
»richtigen« Betriebssystem machten. Im einzelnen brachte 
die Version 2.0: 


ein hierarchisches Dateisystem; 

Dateizugriff über Handles (Dateinummern) statt FCBs 

(Dateisteuerblöcke), die keinen Platz für Pfadnamen 

haben; 

Ein-/Ausgabeumleitung, Pipes und Filter; 

Hintergrunddruck mit PRINT.COM; 

Datenträgernamen (volume label); 

Erweiterung der Dateiattibute; 

die Konfigurationsdatei CONFIG.SYS; 

installierbare Geträtetreiber um Herstellern von Peri- 

pheriegeräten die Einbindung ihrer Systeme zu erleich- 

tern; 

ANSI-Bildschirmtreiber; 

= Anpaßbarkeit an andere Sprachen und länderspezifische 
Funktionen, z.B. zur Abfrage von Datums- und Zeitfor- 
mat; 
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= Verwaltung einer Programmumgebung (environment) 
durch DOS; 

= ein austauschbarer Befehlsprozessor; 

= Disketten mit 9 Sektoren und 360 Kbyte. 


Die Version 2.0 kam im März 1983 auf den Markt und 
war immer noch das Produkt einer sehr kleinen Entwick- 
lungsmannschaft von sechs Leuten, die sich zum Teil im 
Betriebssystem verewigt haben. So heißt einer der Leiter 
der MS-DOS-Entwicklungsmannschaft Mark Zbikowski, 
dessen Initialen »MZ« als Kennzeichnung am Anfang jeder 
EXE-Datei und am Anfang jedes von MS-DOS zugewiese- 
nen Speicherblocks steht. 

Ab der Version 2.01, die nicht von IBM verkauft wurde, 
unterstützte MS-DOS auch das japanische Kanjı-Alphabet 
mit seinen über 7000 Schriftzeichen. 

Trotz seiner vielen Erweiterungen wurden nur 24 Kbyte 
Speicher benötigt. Doch mit dem IBM XT, seiner Festplatte 
und dem neuen DOS begann eine Entwicklung, bei der 
immer leistungsfähigere Programme immer mehr Speicher, 
intern und extern, benötigten, so daß die Standardspeicher- 
größe bald bei 256 Kbyte lag. 


2.1: In dieser Version wurden nur gerinfügige Änderungen 
vorgenommen. Vor allem ging es dabei um die Unterstüt- 
zung des in Deutschland nie verkauften PCjr und den trag- 
baren PC von IBM. Für seine eigenen OEMs verknüpfte 
Microsoft die Versionen 2.01 und 2.1 zu einer Version 2.11, 
die zur ersten Standardversion vieler Hersteller wurde und 
auch heute noch wegen seiner Kompaktheit und Robustheit 
von einigen Anbietern mitgeliefert wird oder bereits im 
ROM eingebaut ist. 2.11 wurde in über 10 Sprachen über- 
setzt, darunter chinesisches Kanji und koreanisch (Hanguel- 
Zeichensatz). Gleich nachdem diese Version fertiggestellt 
war, begann Microsoft mit der Arbeit an der Version 3.0. 


3.0: Die Entwicklung der Version 3.0 erwies sich jedoch als 
schwierig, da inzwischen viele OEMs unterstützt werden 
mußten, der Einsatz in Netzwerkumgebungen geplant war 
und Microsoft bei dem stetigen Wachstum von MS-DOS 
darauf achten mußte, den Programmcode übersichtlich und 
wartbar zu halten. Die Entwicklung beanspruchte mehr 
Zeit, als geplant, so daß die Version 3.0 im August 1984 von 
IBM, zusammen mit dem AT, ohne Netzwerkunterstützung 
angeboten wurde. Einige andere OEMs boten dieses DOS 
unter der Versionsnummer 3.05 an. 

In der Version 3.0 kam die Unterstützung des IBM-AT 
mit Disketten höherer Kapazität (1,2 Mbyte) und weitere 
Festplattentypen hinzu. Weitere wichtige Erweiterungen: 


= Steuerung des Spoolers (PRINT.COM) durch Anwen- 
dungsprogramme; 

= erweiterte Fehlerhinweise und Fehlerbehebungstips für 
Programme; 

= schnellerer Dateizugriff; 

= Dateischutz auf Datei- und Datensatzebene. 


3.1: Die Version wurde kurz nach der Version 3.0 heraus- 
gebracht. Sie ist lange Zeit bei vielen Herstellern der Stan- 
dard gewesen und ist es zum Teil heute noch. Es wurden 
nun Platten in Netzwerken und der gemeinsame Zugriff auf 
Dateien unterstützt. Auch wurden einige Fehler ausgemerzt 
und die internen Dateifunktionen auf Handles umgestellt. 
Deshalb wurde der neue Konfigurationsbefehls FCBS ein- 
geführt, der die Kompatibilität mit Programmen sicherstel- 
len sollte, die noch über FCBs auf Dateien zugreifen. 


3.2: Wichtigste Neuerung dieser Version war die Unterstüt- 
zung von 3 1/2-Zoll-Laufwerken. Durch Einschluß solcher 
Programme wie DISKCOMP in MS-DOS und Umschrei- 
ben einiger anderer externen Utilities wurde die volle Kom- 
patibilität der DOS-Versionen anderer Hersteller mit der 
von IBM sichergestellt. 


3.3: Es kommen zwei neue Befehle hinzu (NLSFUNC und 
FASTOPEN), die Unterstützung internationaler Zeichen- 
sätze wird verbessert und die PS/2-Reihe von IBM unter- 
stützt. 


4.0: Die Version 4.0 erlaubt größere Festplatten (bis 2 
Gigabyte) und die Nutzung von Hauptspeichererweiterun- 
gen nach dem LIM/EMS-Standard 4.0. Die für den Benut- 
zer wichtigste Erweiterung von MS-DOS 4.0 ist die MS- 
DOS-Shell, eine bildschirmorientierte, menügesteuerte 
Betriebssystem-Erweiterung für die Datei- bzw. Verzeich- 
nisverwaltung und das Laden von Anwendungen. Damit ist 
nun eine Art der Bedienung zum Standard gemacht worden, 
die im PC-Bereich vor allem durch Microsoft Windows 
populär gemacht worden ist. 

Die Entwicklung von MS-DOS dürfte damit jedoch noch 
nicht abgeschlossen sein, es wird sicherlich auch in Zukunft 
mit weiteren Versionen zu rechnen sein. Jeder Benutzer hat 
sicherlich gelegentlich die eine oder andere Funktion ver- 
mißt. Dies hat zu einem großen Erfolg solcher Programme 
wie die Norton Utilities oder PC-Tools geführt. Solche 
Möglichkeiten werden jedoch wahrscheinlich nicht Bestand- 
teil von DOS werden. Doch kann ich mir gut vorstellen, daß 
es einmal eine Hilfefunktion ähnlich wie unter OS/2 mit 
dem Befehl HELP geben wird, der einem Hinweise zu Feh- 
lermeldungen gibt. 

MS-DOS bzw. PC-DOS soll nach Angaben von Bill 
Gates inzwischen weltweit auf über 10 Millionen PCs laufen 
und es sollen über 20000 Anwendungsprogramme dafür ge- 
schrieben worden sein. Das ist mit Abstand die größte 
Softwaresammlung für eine Computerumgebung und eine 
Basis, die eine Garantie für den Bestand von MS-DOS ist. 
MS-DOS ist mit acht Jahren für die Verhältnisse der 
schnellebigen Computerszene zwar bereits uralt, doch wird 
es vielen von uns auch in den kommenden Jahren noch ein 
treuer Begleiter sein. Und ganz gleich, wie lange es noch 
verwendet werden wird, einen Ehrenplatz in der Mikro- 
computer-Geschichte hat es sich schon lange verdient. 

Günter Jürgensmeier 
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Verbesserung der Windows-Oberfläche geplant 


Mit der Vorstellung der grafischen Bedienungsoberfläche 
von PC-DOS 4.0 bzw. MS-DOS 4.0 vor wenigen Wochen 
wurde zugleich die Oberflächenstruktur des OS/2 Presen- 
tation Managers vorgestellt, die mit derjenigen von PC- 
DOS 4.0 bzw. MS-DOS 4.0 identisch sein wird. Das Er- 
scheinungsbild des Presentation Managers war bislang nur 
MS-OS/2-Entwicklern bekannt. 

Gegenüber dem Vorbild Microsoft Windows weisen 
DOS 4.0 und der Presentation Manager einige Neuerungen 
auf. So erleichtert eine grafische File- bzw. Pfadstruktur in 
Bauform die Übersicht über Filesysteme auf Datenträgern. 
Dateien werden im Grafikmodus sowohl als Sinnbilder, als 
auch traditionell als achtstelliger Dateiname mit Suffix 
dargestellt. In der Kopfleiste werden Datum und Uhrzeit 
eingeblendet. Ansonsten aber hat sich die Erscheinungs- 
weise gegenüber Windows nicht geändert. PC-DOS 4.0, 
MS-DOS 4.0, Microsoft Windows und der OS/2 Presenta- 
tion Manager entsprechen alle den SAA-Vorgaben der 
IBM. 

Christian Wedell, Geschäftsführer der Microsoft GmbH, 
hierzu: »Mit der neuen Version des Betriebssystems MS- 
DOS 4.0 bzw. PC-DOS 4.0 haben wir nun vom einfachen 
PC über Windows-Rechner bis hin zu neuen OS/2-Rech- 
nern eine durchgehende SAA-Oberfläche mit weitgehend 
identischer Bedienbarkeit. Gemeinsam mit IBM werden wir 
diese Oberflächenstandards auf SAA-Basis ständig wei- 
terentwickeln. So wird eines Tages sicherlich auch 
Microsoft Windows über die File-Strukturdarstellung des 
Presentation Managers verfügen. Diese Planungen und 
Weiterentwicklungen setzen wir völlig unberührt von den 
juristischen Klärungen über Copyrights mit der Firma 
Apple fort.« 

Reiner Doelle, Leiter Produktmanagement PC der IBM 
Deutschland: »DOS 4.0 und der OS/2 Presentation Mana- 
ger wurden von IBM und Microsoft gemeinsam im Hinblick 
auf eine Integration in unser SAA-Konzept entwickelt. SAA 
ist für beide Firmen der Oberflächenstandard der nächsten 
Jahre.« 

Christian Wedell: »Im gemeinsamen Standardisie- 
rungsinteresse von IBM und Microsoft liegt es, wenn 
Microsoft sein Produkt Windows oder vielleicht eines Tages 
auch seine Works-Oberfläche der gemeinsamen Entwick- 
lung anpaßt. Weitgehend identisch ist das Erscheinungsbild 
dieser Produkte bereits heute.« 


Die Brücke zwischen IBM und Apple 


Mit der Ankündigung einer PC-Software-Version von 
Microsoft Mail für den Herbst bahnt sich eine bedeutende 
Verbindung zwischen IBM-PC-Rechnern und den Apple- 
Rechnern auf der Basis des AppleTalk-Netzwerks an. Der 
Empfang und Versand von Mitteilungen, Grafiken und gan- 
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zen Disketten-Inhalten ist damit sowohl von PC zu PC als 
auch zu und von Macintosh-Rechnern möglich. Christian 
Wedell, Geschäftsführer der deutschen Microsoft GmbH: 
»Die neue Microsoft-Software wird die immer wiederkeh- 
rende Diskussion ’Apple oder IBM’ sicher abflauen lassen, 
da nun die Verbindung zwischen beiden Systemen möglich 
wird. Auch zwischen beiden Dateiformaten wird Microsoft 
Mail für Verständigung sorgen.« 

Die für IBM PCs und Kompatible einfach installierbare 
Software berücksichtigt die bekanntesten Steckkarten für 
den PC am AppleTalk-Netzwerk, wie die Karten von Apple, 
TOPS und Tangent. 

Da Microsoft Mail die gleiche Windows-ähnliche Ober- 
fläche wie Microsoft Works hat, bleibt dem PC-Anwender 
die gewohnte Arbeitsumgebung auf dem Bildschirm erhal- 
ten. Im einzelnen enthält Microsoft Mail Features wie Ser- 
ver-Funktion im Hintergrund-Betrieb, Mehrbereichs- 
Unterstützung, Datei-Übertragung, Netzwerk-Leistungen, 
ein stets verfügbares On-Line-Tutorial sowie volle Mailbox- 
Sicherheit durch Paßwort-Schutz. 

Microsoft Mail für PC ım AppleTalk-Netz unterstützt 
voll die Arbeitsumgebung von AppleShare und MultiFinder. 
Microsoft beabsichtigt die Anbindung von Microsoft Mail 
an Microsoft Word 4.0, damit der Word-Anwender Mittei- 
lungen empfangen, verarbeiten und senden kann, ohne sein 
Textprogramm zu verlassen. Microsoft Mail für PC ıst in 
der englischen Version ab 1. Quartal 1989 verfügbar. 


Nun gibt es QuickBasic auch für den 
Apple Macintosh 


Mit Microsoft QuickBasic steht nun auch Apple Macin- 
tosh-Anwendern die vielseitige Leistungsfähigkeit dieses 
Entwicklungs-Werkzeugs zur Verfügung, in dem die Vor- 
teile eines Basic-Interpreters mit denen eines Basic-Com- 
pilers kombiniert wurden. 

Die Interpreter-Vorteile liegen in der Programm- 
Erstellung mit Editor und Debugger. Die Vorteile des 
Compilers machen sich hingegen in der Schnelligkeit der 
Programm-Ausführung bemerkbar. In QuickBasic geschrie- 
bene und compilierte Programme sind eigenständige Applı- 
kationen, die nach ihrer Fertigstellung weder Interpreter 
noch Compiler zum Ablauf benötigen. 

Microsoft QuickBasic eröffnet für den Macintosh neue 
Dimensionen. Dabei ist die einfach beherrschbare Sprache 
Basic sowohl für den professionellen Anwender als auch 
den Amateur eine interessante Alternative in der Pro- 
grammierung. Selbst komplexe Aufgaben werden leicht lös- 
bar unter der neuen, verbesserten Bedienungsoberfläche, 
dıe der vom Macintosh gewohnten Umgangsweise entge- 
genkommt. Zu den besonderen QuickBasic-Eigenschaften 
gehört die Unterstützung für musikalische und farbgrafische 
Aufgaben. Hinzu kommt, daß QuickBasic die Fähigkeiten 
der Prozessoren 68020 und 68881 vollkommen nutzt. 
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Durch die Kombination von Compiler und Interpreter 
auf einer gemeinsamen Bedienungsoberfläche lassen sich 
Kompilierung und Ausführung eines Programms auf einen 
einfachen Klick mit der Maus reduzieren. Der Zugriff auf 
die Macintosh-Toolbox, eine Subroutinen-Bibliothek, ge- 
währleistet ferner, daß Anwendungsprogramme auf ein- 
fache Weise mit Macintosh-Standard-Interfaces versehen 
werden und gewohntes Aussehen sowie bekannte Bedie- 
nungs-Vorteile erhalten. Hierzu ist lediglich die Übernahme 
gewünschter Prozeduren aus der Bibliothek notwendig. 

Die Eigenschaften des enthaltenen Quellcode-Debug- 
gers sind geprägt durch Einzelschritt-Abarbeitung, Trace- 
Funktion und die Möglichkeit, Unterbrechungen zu setzen. 
Im Direkt-Modus können nach jeder Programmunterbre- 
chung die Inhalte von Variablen angezeigt sowie Komman- 
dos unabhängig vom Programm ausgeführt werden. Die 
jederzeit verfügbare »On-Line-Hilfe« von QuickBasic infor- 
miert auf Knopfdruck über Basic-Vokabeln, Bibliotheks- 
Funktionen und Aufrufe, die zu ROM-Routinen gehören. 

Zum Lieferumfang gehören zahlreiche Programm-Bei- 
spiele, die den Einstieg in Basic erleichtern und viele der 
QuickBasic-Besonderheiten anschaulich nahebringen. 
QuickBasic erfordert in dieser modernsten Version 
1 MegaByte RAM ım Macintosh Plus, SE oder II und min- 
destens ein doppelseitiges 800 KByte-Laufwerk. Die Ver- 
wendung einer Festplatte oder eines zweiten 800-Kbyte- 
Laufwerks ist empfehlenswert. Microsoft QuickBasic für 
den Macintosh ist ab Oktober 1988 verfügbar. 


Microsoft liefert 
MS-DOS/CD-ROM-Extensions 2.0 aus 


Unlängst gab Microsoft die Auslieferung der Version 2.0 
der MS-DOS/CD-ROM-Extensions (MSCDEX, Version 
2.0) bekannt. Die neue Version ist in der Lage, CD-ROM- 
Disks zu lesen, die sowohl im Original-»High Sierra«- 
Format als auch in der neueren Version dieses Formates, 
dem 1509660-Format, gepreßt sind. Damit können alle 
Computer unter MS-DOS mit MSCDEX 2.0 auf Files zu- 
greifen, die auf beliebigen CD-ROM-Disks gespeichert 
sind. Applikationsentwickler sind nun nicht mehr gezwun- 
gen, spezielle Software für unterschiedliche CD-ROM- 
Laufwerke zu entwickeln. »Noch wichtiger ist es vielleicht«, 
so Christian Wedell, Geschäftsführer der deutschen Micro- 
soft GmbH, »daß die Anwender sich nun keine Gedanken 
mehr um Datenträger-Austauschbarkeit bei unterschied- 
lichen CD-ROM-Disketten und Laufwerken mehr machen 
müssen«. 

MS-DOS/CD-ROM-Extensions 2.0 unterstützt den 
japanischen Kanji-Zeichensatz, und zwar sowohl was die 
File-Namen als auch was die Files selber betrifft. Es ist nun 
möglich, Audio-Daten, Texte und Grafiken zu integrieren. 
Bei zukünftigen Applikationen ist der Vorteil der Multi- 


media-Fähigkeit von CD-ROMs, die darin besteht, Ton, 
Grafik und Text auf einem einzigen Medium zusammenzu- 
führen, voll nutzbar. MS-DOS/CD-ROM-Extensions 2.0 
läuft auf PC mit MS-DOS 3.1 oder einer höheren Version. 


Mehr als eine Million »Mäuse« verkauft 


In diesen Tagen überschritt Microsoft die Millionen- 
Grenze beim Verkauf der berühmten Microsoft-Maus, die 
ja vielfach als das »Original« bezeichnet wird. Seit Juli 1986 
haben sich die Verkaufszahlen dieses Produktes nahezu 
dramatisch entwickelt: In knapp 12 Monaten sprang der 
Absatz von 500.000 Stück auf nunmehr über eine Million. 
Aus diesem Grunde erwartet Microsoft, daß schon gegen 
Ende dieses Sommers die 1 1/2-Millionen-Marke erreicht 
wird. 

Vor wenigen Wochen stellte Microsoft eine völlig neu- 
entwickelte Maus vor, die neben einem exzellenten Design 
auch für Komfort und leichte Handhabung in Kombination 
mit einer hochqualitativen Grafikunterstützung und Soft- 
ware steht. 

Die Marktdaten zeigen, daß sich der Microsoft-Maus- 
Absatz durch die neue Maus - die übrigens einen Preis für 
die besonders gelungene Formgebung erhielt - noch be- 
schleunigen wird und auch der Einsatz von Grafik-Software 
sowie die Verfügbarkeit von Software-Produkten, die Maus- 
unterstützung bieten, erheblich steigen. 

»Microsoft wird auch weiterhin der Marktführer in die- 
sem Markt bleiben, weil wir verstehen, was die Anwender 
benötigen, um den vollen Nutzen aus grafik- und zeichen- 
orientierten Programmen zu ziehen«, so Christian Wedell, 
Geschäftsführer der deutschen Microsoft GmbH. 

Mit dem wachsenden Einsatz von Grafikprogrammen 
und der Vorstellung leistungsfähiger grafischer Bedie- 
nungsoberflächen wie Microsoft Windows und MS-OS/2 
Presentation Manager, hat auch der Bedarf für Microsoft- 
Mäuse entsprechend zugenommen. Auch verbesserte 
Hardware wie die neuen VGA-Monitore, haben dabei eine 
Rolle gespielt, weil sie dem Anwender die Möglichkeit bie- 
ten, die neuen grafischen Funktionen voll zu nutzen. Der 
Trend, Mausunterstützung sowohl für grafik- wie auch für 
zeichenorientierte Software zu bieten, nimmt ebenfalls zu. 
Software-Entwickler erkennen in zunehmendem Maße, in 
welcher Weise eine Maus die Anwender-Produktivität ver- 
bessern kann. Deshalb unterstützen bislang mehr als 250 
Software-Pakete die Microsoft-Maus. 

Die neue Microsoft-Maus ist in einer Reihe unter- 
schiedlicher Software-Pakete ım Handel erhältlich. Eine 
dieser Versionen ist z.B. für das Programm »Paintbrush« 
ausgelegt, ein Zeichenprogramm, das die Firma Z-Soft für 
die MS-DOS-Betriebssystem-Umgebung entwickelt hat. 
Der empfohlene Verkaufspreis dieser Version wird 390 
Mark zuzüglich Mehrwertsteuer betragen. Eine andere 
Version, die zu einem empfohlenen Preis von 650 Mark zu- 
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züglich Mehrwertsteuer angeboten wird, umfaßt Microsoft 
Windows 2.0 und Z-Soft PC-Paintbrush für Windows. Die 
dritte Version, mit einem empfohlenen Verkaufspreis von 
525 Mark zuzüglich Mehrwertsteuer, wird zusammen mit 
EasyCad, einem Programm der Firma Evolution Compu- 
ting, angeboten. EasyCad ist ein leistungsfähiges CAD-Pro- 
gramm. Alle Versionen enthalten die Software »Mouse 
Menus«. 


Die HP-Newwave-Applikationsumgebung wird 
von Microsoft im Rahmen zukünftiger Excel- 
Versionen unterstützt 


Microsoft und Hewlett-Packard haben in diesen Tagen 
eine Vereinbarung getroffen, auf deren Basis die beiden 
Unternehmen gemeinsam das Tabellen-Kalkulationspro- 
gramm Microsoft Excel für die HP-NewWave-Umgebung 
entwickeln und vermarkten wollen. 

HP-NewWave ist eine fortschrittliche Software-Appli- 
kationsumgebung, die auf der grafischen Bedienungsober- 
fläche Microsoft Windows, Version 2.0, basiert. Sie erlaubt 
dem Anwender das Arbeiten mit mehreren Applikations- 
programmen und vereinfacht das Manipulieren von Daten 
aus verschiedenen Quellen. 

HP-NewWave verbessert darüber hinaus die PC-Inte- 
gration, indem das Programm dem Anwender einen soforti- 
gen Überblick über die gesamten Informationsressourcen in 
einem Netzwerk gibt. 

»Mit den leistungsfähigen, systemweiten Diensten, die 
HP-NewWave bietet, macht Microsoft Excel einen weiteren 
Schritt vorwärts zum leistungsfähigsten, flexibelsten und am 
einfachsten zu handhabenden Tabellen-Kalkulationspro- 
gramm, das es auf dem Markt gibt«, so die Stellungnahme 
von Christian Wedell, Geschäftsführer der deutschen 
Microsoft GmbH, zu dem Abkommen zwischen Microsoft 
und Hewlett-Packard. 

Robert J. Frankenberg, General Manager der Informa- 
tion Systems Group von Hewlett-Packard, meint, daß aus 
Sicht seines Unternehmens die Vereinbarung mit Microsoft 
einen großen Fortschritt in der Akzeptanz von HP- 
NewWave in Software-Entwickler-Kreisen bewirkt: »Wir 
sind sehr erfreut, ein Produkt der neuen Software-Genera- 
tion wie Microsoft Excel zu haben, das an die HP- 
NewWave-Umgebung angepaßt ist und glauben, daß sich 
viele HP-NewWave-Kunden für dieses Tabellen-Kalkulati- 
onsprogramm entscheiden werden.« 

Die Verbesserungen bezüglich HP-NewWave werden 
nach einer Darstellung von Microsoft auch in das Microsoft 
Excel Standard-Produkt integriert, so daß Anwender keine 
spezielle Version erwerben müssen, wenn sie mit HP- 
NewWave arbeiten. Die neue Version von Microsoft Excel 
wird den PC-Anwendern Zugriff auf die wichtigsten Funk- 
tionen von HP-NewWave, einschließlich der HP-Objekt- 
Management-Funktion und »Agents«, einer Funktion zur 
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Automatisierung systemweiter Tasks, verschaffen. Die neue 
Microsoft Excel-Version wird darüber hinaus eine Platt- 
form zur Implementierung von KI-Funktionen (Künstliche 
Intelligenz) seın. 

Die Objekt-Management-Funktion nutzt die Möglich- 
keit des dynamischen Datentransfers bei Microsoft Excel, 
so daß der Anwender »Hotlinks« oder Brücken zwischen 
Microsoft Excel und anderen Applikationsprogrammen ein- 
richten kann, die unter HP-NewWave laufen. Einmal einge- 
richtete Verbindungen werden kontinuierlich durch HP- 
NewWave verwaltet und gestatten die gemeinsame Nutzung 
von Daten, die auch automatisch in den verschiedenen Pro- 
grammen und Dateien aktualisiert werden. Durch Einsatz 
der Objekt-Management-Funktion werden Daten aus 
Microsoft Excel-Tabellen zu Objekten, die auf einfache 
Weise mit Objekten aus anderen Programmen zusammen- 
geführt werden können, um daraus ein Dokument zu er- 
stellen. 

Das im November 1987 vorgestellte HP-NewWave-Ent- 
wicklungskit wird nun an alle Interessenten ausgeliefert, die 
Applikationen für die HP-NewWave-Umgebung schreiben 
wollen. Die Anwendungsumgebung wird im späteren Ver- 
lauf dieses Jahres verfügbar sein. Eine Unterstützung für 
HP-NewWave/Microsoft Excel ist ab Mitte 1989 lieferbar. 
Die Firma Hewlett-Packard plant, eine Vertriebslizenz für 
Microsoft Excel zu erwerben, so daß der Verkauf auch über 
den Vertriebsapparat von HP erfolgt. 

Hewlett-Packard und Microsoft haben die Absicht, je- 
weils vergleichbare Funktionen und Möglichkeiten für die 
zukünftigen Versionen von Microsoft Excel und HP-New- 
Wave zu entwickeln, die auf dem Microsoft-Multitasking- 
Betriebssystem OS/2 und der grafischen Bedienungsober- 
fläche Presentation Manager laufen. 


Accessories No.l: 
Toolbox für Microsoft Windows 


Die Gesellschaft für Computeranwendungen GCA, stellt 
mit Accessories No.1 jetzt eine »Toolbox« für den Anwen- 
der von Microsoft Windows zur Verfügung. Accessories 
No.1 ist ein Produkt langjähriger Erfahrungen des Ludwigs- 
burger Unternehmens aus der Programmierung mit Micro- 
soft Windows/Presentation Manager, dem Applikations- 
Trägersystem der Zukunft. 

Andere für Microsoft Windows verfügbare Applikatio- 
nen, wie z.B. Pagemaker oder Excel, haben sich erfolgreich 
am Markt etabliert. Die in der Praxis dringend benötigten 
kleinen Anwendungen, Utilities und Hilfsprogramme sind 
jedoch unberücksichtigt geblieben. Diese Lücke schließt 
jetzt Accessories No.1. Es ist die erste Kollektion aus einer 
Serie von Programmen für Microsoft Windows. Ziel dieser 
Programme ist die sinnvolle Integration von Daten und 
Anwendungen unter Microsoft Windows. 
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| u Fr = C:DOS_DRIVE_C \WIHDOUS. 
SCRIPT .MW ROMAH.FOH 
ABC .TXT MEIHPLAH.TXT SCRIPT.FOH 
| ABLAGE .EXE HEHU .EXE SPI .HHU 
BRIDGE ..EXE HEHU.PCK SPOOLER .EXE = Photo 


ERIDGE .FC& HEHUPICT.PCK STARTUP.HHU Ben) 
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EUTPAIHT .EXE 
DEMO „HH 
BIGI.-EXE 
5 DRUIHFO.EXE 
5 ERHST.HHU 
# HELVE.FOH 
ICONS „PCK 
IHFO.TAT 
KALEHDER.EXE PH z 





Sieben Anwendungen in der neuen Toolbox 


Das neue System bietet dem Endanwender Programme zur 
Gestaltung individueller, grafischer Menüsysteme, zur Kon- 
vertierung von GEM-Dateien in Window-Formate, zur Ab- 
speicherung und Bearbeitung verschiedenster Bildschirmin- 
halte, Sicherung des eigenen Systems gegen unberechtigten 
Zugriff sowie Analyse des Druckers und der Druckertrei- 
ber. Den Leistungsumfang runden eine Digitaluhr und ein 
kleineres »Unterhaltungsprogramm« ab, 

Das mit dem Paket gelieferte Menüsystem MENU opti- 
miert das Konzept einer klaren, durchgängigen, einfach zu 
bedienenden Benutzeroberfläche. Das Menüsystem erlaubt 
die Gestaltung individueller graphischer Menüs. Graphische 
Symbole (Icons) stehen stellvertretend für Programme oder 
Makros. Die Aktivierung der einzelnen Menüoptionen er- 
folgt durch Anklicken mit der Maus oder durch Selektion 
über die Tastatur. 

BRIDGE macht die Konvertierung von GEM nach MS- 
Windows möglich. Alle GEM-Dateiformate werden auto- 
matisch in äquivalente MS-Windows-Formate umgesetzt. 
Konvertierte Dateien bleiben editierbar und können dann 
unter MS-Windows weiterbe- und verarbeitet werden. Dies 
gilt selbstverständlich für alle Arten von Bild-, Pixel- und 
Textdateien. 

PHOTO ist ein Werkzeug für die Dokumentation oder 
zur Bildübernahme von Programmen ohne direkte Daten- 
austauschmöglichkeit. 

Bildschirmausschnitte oder ganze Screen-Inhalte können 
mit PHOTO einfach abgespeichert und weiterbearbeitet, 
ausgedruckt oder in andere Programme übernommen wer- 
den. PHOTO ist kompatibel zur gesamten von MS-Win- 
dows unterstützten Hard- und Software. 

KEEPAWAY bietet dem Anwender einen Passwort- 
schutz für das laufende System, wobei im Hintergrund alle 
arbeitenden Programme ungestört weiter ablaufen. 

Mit dem Auskunfts- und Analyseprogramm DRVINFO, 
kann der Anwender die immer wieder auftretenden Un- 


klarheiten bezüglich Druckern und Druckertreibern erken- 
nen und beseitigen, da das Programm alle Informationen 
über den Drucker und die vom Treiber unterstützten Funk- 
tionen abrufbar hält. 

Als platzsparende Alternative zu UHR.EXE aus MS- 
Windows ist in Accessories No.l die Digitaluhr DIGI mit 
Datum enthalten. 

Das siebte Programm in der Toolbox ist COOKIE. Ner- 
venaufreibend und unsinnig bringt es einfach Spaß bei der 
Arbeit am Rechner. 

Die ausführliche Dokumentation des Produkts und die 
im Lieferumfang enthaltenen Installationsprogramme er- 
lauben es jedem Anwender, die weitgehend selbsterklären- 
den Module der neuen Toolbox sofort unter MS-Windows 
einzusetzen. 


- PC-Anwendungspraxis 


Schluß mit komplizierten Bedienungs- ® Er vereinigt alles, was Sie zum selb- 
anleitungen und trockenen Fachbüchern! ständigen Studium zu Hause benötigen. 
Schluß mit der lästigen Rumfragereil 12 leichtverständliche Lehrbriefe. 4 aus- 
@ Der neue PC-Anwendungspraxis- gezeichnete Anwenderprogramme, ein Set 
Fernlehrgang eröffnet Ihnen freie Bahn raffinierter Lerndisketten und eine wirk- 
zu den modernen Computer- same Studienbetreuung. 
anwendungen! ® Er bildet Sie systematisch und gründlich 
vom Einsteiger zum versierten PC-Profi 

| eTW aus: Kompetenz im Umgang mit MS-DOS, 
Vom Einsteiger Gewandtheit im Software-Einsatz und 
zum PC-Profi ze Sicherheit in allen prufessionellon PC-An- 

er wendungen. ; 


= [7 Senden Sie mir den ersten Lehrbrief für drei Wochen 
& kostenlos und unverbindlich zum Teststudium. 
ea [7] Senden Sie mir zunächst nur die Informationsschnift. 


Name 


Anzeige bitte Straße/Nr. 
ausschneiden 
und im PLZ/Ort 


Briefumschlag 
einsenden an: Mein PG-Modell 


Dr.-Ing. P. Christiani - Postlach - 7750 Konstanz 
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Microsoft Works Version 2.0 
für den Macintosh 


Mit der für den Herbst vorgesehenen 
Auslieferung der englischen Version 
von Microsoft Works 2.0 werden wich- 
tige Programmverbesserungen für den 
Macintosh verfügbar. Microsoft Works 
Version 2.0 vereint fünf unterschied- 
liche Aufgaben: Textverarbeitung, Ta- 
bellenkalkulation, Datenbank, Kom- 
munikation und Grafik in einem einzi- 
gen Programmpaket. 

Microsoft Works, das sich in kur- 
zer Zeit seinen Platz unter den drei 
Spitzenprodukten dieser Kategorie für 
den Macintosh erobern konnte, bietet 
in der Version 2.0 eine Reihe zusätz- 
lıcher Leistungen. So wurden die grafı- 
schen Fähigkeiten erweitert und ver- 
bessert. Ferner sorgen Makros für die 
Automatisierung stets wiederholter 
Aufgaben. Ein integriertes Recht- 
schreibprogramm ergänzt die Textver- 
arbeitung. Außerdem können umfang- 
reichere Spreadsheets mit allen Infor- 
mationen einschließlich einer Datum-/ 
Zeitfunktion verarbeitet werden. 

Die leichte Erlernbarkeit, die 
Works bekanntlich auszeichnet, wird 
durch ein CBT(Computer Based Trai- 
ning)-Lernprogramm, das am Bild- 
schrm angewählt werden kann, 
zusätzlich unterstützt. 

Microsoft Works Vielseitigkeit, die 
einen schnellen Einstieg in die profes- 
sıonelle Anwendung ermöglicht, ent- 
hält für den Bereich der Grafik bezie- 
hungsweise Geschäftsgrafik zahlreiche 
Hilfsmittel zum Zeichnen von Linien, 
Kreisen, Rechtecken, Winkeln und 
Polygonen sowie zum freihändigen 
Zeichnen. Diese grafischen Fähigkei- 
ten können sowohl im Spreadsheet als 
auch in der Textverarbeitung ange- 
wendet werden. Die einzelnen Grup- 
pen und Elemente einer Zeichnung 
können zur nachträglichen Bearbei- 
tung selektiert werden. 





Nach 5 106 UrhG ist das Kopieren von urheberrechtsgeschützten Computerprogrammen strafbar. 





DIE NEUEN MICROSOFT 
COMPILER FÜR 
MS-DOS UND MS-05/2. 


Start frei für Höhenflüge. Die neuen leistungsfahi- 
gen Compiler von MICROSOFT erlauben Ihnen die 


Entwicklung professioneller Applika- 


mit ihnen können unter MS-DOS ent- bis zul GB 
Multitasking; 
wickelte Programme problemlos auf Interprozeß- 
MS-0S/2 portiert werden. Denn sie —— 
sind mit allen dafür notwendigen Pro- ches Programmie- 
| ren und Debuggen 
grammierwerkzeugen ausgestattet: ., Dynamisch linkbare 
dem konfigurierbaren und program- Shen und 
| e 
mierbaren MICROSOFT EDITOR, dem -- WINDOWS- und 
derzeit effizientesten Debugger für die Ne 
Fehlersuche, MICROSOFT CODEVIEW mierung mit 
- mit LIB, LINK, MAKE, BIND usw... Maenner, 
Aber das ist noch lange nicht alles - » Neue Version des 
das Familien-Konzept bringt Sie noch en 
einen Schritt weiter in Richtung profes- + unterstützt 
Multiple-Thread- 
sioneller Programmentwicklung. Alle programme 
neuen MICROSOFT COMPILER ent- + Unterstützt 
=; dynamisch gelinkte 
halten dieselben Tools. Damit ist es Module 
jetzt möglich, gemischt-sprachliche ale 
Programme unter einer einheitlichen barer Makro-Editor 
= | Inkremental-Linker, 
Entwicklungsumgebung zu erstellen: ginder, MAKE-Utili- 
von MICROSOFT C 5.1. über MASM 2 a 
| 5 1; 
51. FORTRAN 41. BASIC 6.0, fürms-08/2 und 
für MS-DOS 


COBOL 3.0 bis PASCAL 4.0. Und zwar 
unter MSDOS und MS-05/2! 


Haben Sie noch Fragen? Dann fragen Sie uns. 
Denn wir haben heute schon die Antwort für 


morgen parat. 


ms/nos) |ms/as/2 [me 3 


___ ZUKUNFT DER SOFTWARE 
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Bitte senden Sie mir Informationsmaterial zu: [] MICROSOFT COMPILERN. 
U] System Journal, die spezialisierte PC-Fachzeitschrift für Software-Entwicklung 
Ich nutze Software: [] prvat DJ beruflich/"Branche — 

Mein Rechner: DJ) MSD0S DJ MS-0S/2 DJ Macintosh 

Bitte senden Sie den Coupon an: Microsoft GmbH Erdinger Landstraße 7 


Absender nicht vergessen. 


8011 Aschheim-Dornach 
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Drei weitere Leistungen stehen 
allen fünf Programmen innerhalb des 
Pakets zur Verfügung: Farbunterstüt- 
zung für den Macintosh II, Druckvor- 
schau am Bildschirm zur Begutach- 
tung einer Seite vor dem Ausdruck 
sowie ein Makrorecorder, der zur Auf- 
zeichnung eines Arbeitsablaufs zum 
Zweck der späteren wiederholten 
Ausführung dient. 

Eine in der Textverarbeitung ent- 
haltene Rechtschreibprüfung kann auf 
ein Wörterbuch zurückgreifen, das auf 
die eigenen Bedürfnisse abgestimmt 
und erweitert werden kann. Verbesse- 
rungen der Mailmerge-Funktionen in 
der Textverarbeitung erlauben die 
Verwendung mehrfacher Aufzeich- 
nungen, schließen die Zusammenfas- 
sung von Textdateien und Datenbank- 
auszügen ein und vereinfachen die 
Verwendung mehrspaltiger AdreBauf- 
kleber. 

Das Tabellenkalkulationsmodul er- 
laubt bei Works 2.0 nun 256 Spalten 
und bis zu 16.382 Zeilen. Datum-/ 
Zeitfunktionen dürfen enthalten sein. 
Neben den Daten der einzelnen Zellen 
kann man nun auch Informationen 
über jede einzelne Zelle speichern. 
Das Datenbankmodul wurde durch 
Einfügen von Datum-/Zeitfunktionen 
und durch flexiblere Auswertungs- 
fähigkeiten verbessert. 

Datenimport und -export ver- 
schaffen Microsoft Works auf dem 
Macintosh Kompatibilität zu Microsoft 
Word und Microsoft Excel durch 
Dateien im RTF- sowie SYLK-For- 
maät. 

Microsoft Works 2.0 für den Mac- 
intosh wird in englischer Version ab 
Oktober 1988 verfügbar sein. Eine 
deutsche Version wird voraussichtlich 
im 1. Quartal 1989 in den Handel 
kommen. 





Das Debuggen ist ein unverzichtbarer und un- 
vermeidbarer Schritt bei der Entwicklung jedes 
Programms. Bei normalen MS-DOS-Program- 
men beginnt das Debuggen gewöhnlich mit dem 
Einbau zahlloser Print-Anweisungen in das Pro- 
gramm. Wenn das nicht hilft, kommt es zur 
Eskalation der Schlacht und zu Sitzungen mit 
DEBUG, CodeView oder sogar einem Hardware- 
Debugger. 


Unglücklicherweise funktionieren viele der traditionellen 
Test-Techniken in der Windows-Umgebung nicht. In den 
letzten Monaten hat es gewaltige Verbesserungen in Bezug 
auf das Debuggen unter Windows gegeben, besonders 
durch die Ankündigung von CodeView für Windows (siehe 
separaten Artikel). Doch die Programmierer kämpfen 
immer noch mit der schwierigen Aufgabe des Debuggens 
und Feilens an ihren Windows-Anwendungen. 


Methoden des Debuggens 


Theoretisch gibt es viele Arten, Debug-Methoden zu klassi- 
fizieren. Häufig wird das Debuggen in drei Kategorien ein- 
geteilt, die invasiven, die nichtinvasiven und die kombinier- 
ten Techniken. 

Beim invasiven Debuggen wird normalerweise der 
Quellcode der Anwendung geändert und neu kompiliert. 
Die Debug-Tools und ihre Einsprungspunkte werden ganz 
einfach Teil des Programms, wodurch diese Technik sehr 
leicht zu implementieren ist. Zwei Beispiele für diese Tech- 
nik sind fest codierte Meldungsboxen und Ausgabeanwei- 
sungen, die auf den Bildschirm oder eine temporäre Datei 
umgeleitet werden. 

Diese Methode reicht oft aus, um einen großen Anteil 
der Codierungs- und Algorithmen-Fehler abzufangen. Bei 
geschickter Anwendung kann diese Methode das Haupt- 
Debugging-Tool für große und komplizierte Anwendungen 
sein. 

Diese Methode macht es jedoch notwendig, daß man 
Zugriff auf den fehlerhaften Quellcode hat, was ein Pro- 
blem ist, wenn man eine Anwendung testet, die auf ein Pro- 
gramm reagiert, das man nicht selbst geschrieben hat. 
Zusätzlich wird durch den Einbau der Debug-Anweisungen 
oder Tools in die Anwendung der Charakter des Problems 
verändert, wodurch die Situation weiter verkompliziert wird. 
Dies erweist sich besonders dann als nachteilig, wenn man 
es mit systemnahen Dingen wie der Speicherverwaltung und 
der Kommunikation zwischen Programmen zu tun hat, 

Beim nichtinvasiven Debuggen ist keine Änderung oder 
Neukompilierung einer Anwendung notwendig. Das Debug- 
Tool und seine Steuerfunktionen stehen außerhalb der 
Anwendung und können gewöhnlich bei einem existieren- 
den Programm verwendet werden. Beispiele für diese 
Technik sind das Aufzeichnen von Meldungen, Eingriffe für 
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Bild 1: Mit der Debug-Utility können Sie die Operationen 
einer Anwendung protokollieren und untersuchen. 


die Protokollierung, Alias-Bibliotheken, Profiler und sogar 
Hardware-Debugger. 

Wenn die nichtinvasive Methode korrekt eingesetzt 
wird, kann sie eine Menge extern erhaltener Diagnoseinfor- 
mationen zur Verfügung stellen. Diese Methode ist beson- 
ders beim Debuggen komplexer Verbindungen zwischen 
Anwendungen nützlich. Des weiteren wird mit externen 
Debug-Tools die eventuelle Aufsummierung von Fehlern 
eingeschränkt. 

Auf der negativen Seite ist zu sagen, daß diese Methode 
oft kompliziert ist: Es wird nur über extern wahrnehmbare 
Ereignisse berichtet und sie tendiert dazu, viele unwichtige 
Informationen zu erzeugen, die die wenigen wichtigen 
Daten umgeben. Der Programmierer muß gewöhnlich die 
mitgeteilten Ereignisse interpretieren und nach dem 
suchen, was wirklich wichtig ist. 

Beim kombinierten Debuggen werden sowohl die inva- 
sive als auch die nichtinvasive Methode verwendet. In den 
meisten Fällen braucht das Programmm nur mit einem 
anderen Compilerschalter neu kompiliert werden, der Sym- 
boldateien oder andere für das Debug-Tool nützliche Infor- 
mationen erzeugt. Beispiele für diese Methode sind Code- 
View, SymDeb und andere, kompliziertere Hardware- 
Debugger, die die Interna von Anwendungen handhaben 
können. 

Diese Methode stellt wahrscheinlich die leistungsfähig- 
ste dieser Debug-Techniken dar, denn damit können sogar 
heimtückische Programmierweisen und Systemfehler fest- 
gestellt und beschrieben werden. Zusätzlich kann der Pro- 
grammierer beim Testen gewöhnlich die internen Daten- 
strukturen untersuchen, die einem einen noch besseren 
Überblick über eine bestimmte Situation ermöglichen. 

Um diese Methode effektiv einzusetzen, muß der Pro- 
grammierer intime Kenntnisse des verwendeten Betriebs- 
systems und der Hardware haben. Die Leistungsfähigkeit 
dieser Methode wird dadurch geschmälert, daß sie sehr 





Windows 


/% 
* WINDOWS 2.88 DEBUG UTILITY - HEADER FILE 
2) 


* LANGUAGE : Microsoft GC 5.8 
* MODEL : small or medium 
* STATUS : operational 

# 

* 12/11/87 1.84 - Kevin P. Welch - initial creation. 
#* 

“f 


[/* debug control panel constants #/ 

\#define BUG OFF 188 /* debug inactive #/ 
#define BUG ON 181 /* debug active */ 
#define BUG COUNT 182 /* count debug events */ 
#define BUG DISPLAY 183 /* display debug events */ 
define BUG FILTER 184 /* filter debug events %/ 
#define BUG FILTERLIST 185 /* filter list */ 
#define BUG _LOG 186 /* log debug events */ 
#define BUG LOGFILE 187 /* debug log file */ 
#define BUG _OK 108 /* OK button */ 

define BUG CANGEL 189 /* CANCEL button */ 


I/* default dialog box definitions */ 
|#define DEF B | (BS_DEFPUSHBUTTONIWS_TABSTOP IWS_CHILD) 


/* standard dialog box definitions */ 


#define STD_FRAME (SS BLACKFRAMEIWS CHILD) 

#define STD_CHECKBOX {BS_CHECKBOX|WS TABSTOP|WS_ CHILD) 
|#define STD BUTTON (BS_PUSHBUTTONINS TABSTOP}WS CHILD) 
#define STD RADIO (BS RADIOBUTTONIWS TABSTOPIWS CHILD) 
Zdefine STD EDITFIELD 

| (HS_BORDERIWS _TABSTOP IWS_CHILDIES_AUTOHSCROLL) 


/* debug function definitions */ 

ıBOOL F Debug(); 

BOOL FAR PASCAL DebugControl( HWND ); 

BOOL FAR PASCAL DebugSetup( HWND, WORD, WORD ); 

BOOL FAR PASCAL DebugControlDigFn( HUND, WORD, WORD, LONG ); 


Listing 1: Die Header-Datei der Debug-Utility. 


lernintensiv ist und sehr viele Informationen erzeugt. Viele 
Programmierer zögern, sie zu verwenden, außer bei den 
unübersichtlichsten und schwierigsten Problemen. 


Eine Windows-Debug-Utility 


Nach der Entwicklung zahlreicher Windows-Anwendungen 
und dem Kampf mit den Problemen des Debuggens ent- 
schied ich mich, ein einfaches invasives Debug-Tool zu ent- 
wickeln, das mir einen sinnvollen Überblick über die Ope- 
rationen ermöglichen sollte, die in einer fehlerhaften 
Anwendung durchgeführt werden. 

Meine Bemühungen führten zur Windows-Utility 
Debug, einem kleinen Objekt-Modul (kompiliert ca. 4 
Kbyte), das auf Wunsch zu einem Programm hinzugelinkt 
werden kann. Es bietet in der Windows-Umgebung ähnliche 
Debug-Möglichkeiten wie mit Ausgabeanweisungen. 

Sobald Debug in Ihre Anwendung integriert ist, können 
Sıe die Werkzeuge der Utility dazu verwenden, zahlreiche 
interne Programmereignisse anzuzeigen oder aufzuzeich- 
nen. Der ganze Debug-Prozeß wird über eine zentrale Steu- 
ertafel kontrolliert, die über das Systemmenü der Anwen- 
dung zu erreichen ist (Bild IT). In dieser Steuertafel kann 
man: 





/* 
* WINDOWS 2.80 DEBUG UTILITY - SOURCE CODE 
x 


| * LANGUAGE : microsoft C 5.8 
MODEL : small or medium 
STATUS operational 


: 12/11/87 1.89 - Kevin P. Welch - initial creation. 
5 


include “windows.h> 
I#include £string.h> 
\#include <fentl.h> 
I#include <sys\types.h> 
|#include <sys\stat.h> 
|#include "debug.h” 





[/* internal macros */ | 
|#define TOSCLE(K Y)CheckDigkuttonx.y, tIsDlgButtonChecked(x,y)) | 
/define ENABLE(x,y.2) EnableHindow(GetDlg ten(x,Y),2z) 


/* general definitions */ 

#define SHARED S IREADIS IWRITE 

define MODE _APPEND OÖ ' ROWRIO APPENDIO BINARY 
fdefine MODE CREATE OÖ | RDWRIO GREATIO | BINARY 


/* listbox viewport definitions */ 
#define PORT X 28 /* viewport x origin #/ 
#define PORT_Y 48 /* viewport y origin #/ 
|#define PORT _WIDTH 468 /* viewport width */ 
#define PORT_HEIGHT 148 /* viewport height */ 
|/* debug statement data structure */ 


#define MAX_FILTER 32 /* maximum filter categories */ 


typedef struct { 


| /* general options #/ 
| BOO bSetup; /* debug setup flag */ 
BOOL  bäctive; /* debug active flag */ 


/* count options #/ 
BOOL bCount; 
LONG 1MsgCount; 


/* display options */ 
BOOL bDisplay; 
HWND hlListBox; 
WORD  wEntries; 
WORD wMaxEntries; 


/* count events flag */ 
/* debug nessage count */ 


/* display debug events */ 
’/* 11stbox window handle */ 
/* current listbox lines */ 
/* naxinum listbox lines */ 


/* filter pr ieuE */ 

BOOL bFilter; /* filter debug events */ 

KORD wFilterSize; /* size of categories */ 

KORD  Filter[MAX_ FILTER]; /* list of categories */ 

/* log-file options */ 

BOOL bLog; 

char  szLogFile[64]; 
} OPTIONS; 


* grens data definitions %*/ 
tatic OPTIONS Options; 


/* 10 debug events */ 
u 


“ debug log file name */ 


/* 
DebugSetup( hund, wsg, wMax ) 
# 


hind main application window handle 
wWMsg debug control panel system message 
wMax maximum number of debug lines 


: bResult 


* This function is responsible for creating the debug viewport 
* window class and for KING the control panel to the 

* system menu of the window handle provided (this implies that 
* the window handle provided has a system menu). 
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* 

* A boolean value of TRUE is returned if the setup process was 
* successful. 
* 


*/ 
BOOL FAR PASCAL DebugSetup( hind, wsg, wMax ) 
HUND  hind; 


WORD wfisg; 
WORD wMax; 


/* local variables */ 
BOOL . 











/* boolean result */ 











HMENU hSysMenu; /% a en menu handle */ 
WNDCLASS WndClass; /* temporary class structure */ 
HANDLE hInstance; /* handle to window instance */ 
char szModule[64];/* main module file name */ 





/* boolean result */ 
bOk = FALSE; 
hInstance = GetWindowWord( hind, GH | HINSTANCE ); 


/* check if debug already activated */ 
if ( tOptions.bSetup ) { 







/* retrieve system menu handle *%/ 
hSysMenu = GetSystemMenu( hund, FALSE ); 
if ( hSysMenu ) { 





/* change system menu to reflect control panel */ 

ChangeMenu( hSysMenu, @, NULL, 999, 
. ni hörten. SEPARATOR ); 

ChangeMenu ysMenu, ß, 

APPENDIMF_ STRING); ii 


/* create listbox window -initially hidden */ 
Options. hListBox = CreateWindow( 
"LISTBOX”, /* class name */ 
/* window caption %*/ 
WS BORDERIWS_ VSCROLL, 
/* window style */ 






„n ‚ WMsg, 














PORT X, /* x position #/ 
PORT_Y, /* y position */ 
PORT WIDTH,  /* width ®/ 

PORT HEIGHT, /®* height */ 

NULL, /* parent window */ 
NULL, /* menu */ 

hInstance, /* instance handle */ 







(LPSTR)NULL /* other data */ 






/* continue if successful */ 
if ( Options.hListBox ) { 


dei define options data */ 
= TRUE; 


ce bSetup = TRUE; 
Options.wMaxEntries = wMax; 


/* define default log file nane *#/ 
GetModuleFileName( hinstance, 
szModule, sizeof(szModule) ); 


*strrchr(szModule,’.') = 8; 
sprintf( 
ee .szLogFile, 


(char *)(strrehr(szModule, \\’)+1) 



















/* return final result */ 
return( bOk ); 
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Bild 2: Die Steuertafel der Debug-Utility. 


das Debuggen ein- oder ausschalten, 

unerwünschte Debug-Ereignisse herausfiltern, 

die Debug-Ausgabe auf dem Bildschirm ausgeben oder 
in einer Datei speichern. 


Funktionen der Debug-Utility 


Das Debug-Modul, das zu Ihrer Anwendung hinzugelinkt 
wird, besteht aus zwei Dateien, DEBUG.H und DEBUG.C 
(Listings 1 und 2). Das Debug-Modul besteht aus vier 
Funktionen, von denen drei in Ihrer Anwendung explizit 
verwendet werden können. 

Die erste Funktion ist DebugSetup, die für die Anlage 
des Debug-Fensters und das Hinzufügen des Debug-Befehls 
zum Systemmenü der Anwendung zuständig ist. Diese 
Funktion muß mit der Fenster-Handle, einer Meldung und 
der maximalen Anzahl Zeilen, die von Debug verwaltet 
werden sollen, aufgerufen werden. 

Die Funktion DebugSetup nimmt an, daß es im Fen- 
ster der übergebenen Handle ein Systemmenü gibt. Wenn 
das Hauptfenster kein Systemmenü enthält und sie auf 
andere Weise auf die Debug-Steuertafel zugreifen wollen, 
können Sie entsprechende Änderungen vornehmen. 

Immer wenn die Option Debug zum Systemmenü hin- 
zugefügt wird, wird die Meldungsnummer der Steuertafel 
mit der Option gleichgesetzt und zurückgegeben. Die Mel- 
dungsnummer wird im Parameter wParam der Meldung 
WM_SYSCOMMAND übergeben. Um die Steuertafel anzuzei- 
gen, muß man diese Meldung explizit abfangen und dann 
die Funktion DebugControl aufrufen. 

Der Parameter, der in DebugSetup die maximale 
Anzahl Zeilen im Fenster angibt, begrenzt den Speicher- 
verbrauch der Utility, während im Fenster Debug-Zeilen 
ausgegeben werden. Das Debug-Fenster besteht aus einer 
verschiebbaren Listenbox, die eine Reihe von formatierten 
Debug-Zeilen enthält. Die Debug-Zeilen in diesem Fenster 





Windows 


werden laufend an die vorhandenen angehängt, bis das 
angegebene Maximum erreicht ist. Ab diesem Punkt ersetzt 
jede weitere Debug-Zeile eine frühere. Obwohl die maxi- 
male Anzahl der Debug-Zeilen, die im Fenster verwaltet 
werden können, nur durch den vorhandenen Speicher ein- 
geschränkt ist, sollte man die Anzahl in den meisten Fällen 
auf unter 100 begrenzen. 

Mit der Funktion DebugControl kann man die Debug- 
Steuertafel anzeigen und die aktuellen Debug-Optionen 
verändern (Bild 2). Diese Funktion wird normalerweise als 
Teil der Routine aufgerufen, die die Meldung WM_SYSCOM- 
MAND behandelt, die wiederum aktiviert wird, wenn der 
Benutzer im Systemmenü die Option Debug wählt. Diese 
Funktion ruft DebugControlD1gFn mit der vordefinierten 
Dialogbox-Ressource auf. 

DebugControlDlgFn ist für die Bearbeitung aller 
Meldungen zuständig, die mit der Dialogbox (der Steuer- 
tafel) von Debug zu tun haben. Der Initialisierungsabschnitt 
dieser Funktion (unter WM_INITDIALOG) setzt die aktuel- 
len globalen Debug-Optionen in entsprechende Schalter 
und Editierfelder um. Der Befehlsabschnitt (unter 
WM_COMMAND) verarbeitet die verschiedenen Schaltermel- 
dungen und aktiviert oder deaktiviert Felder dementspre- 
chend. Der Beendigungsabschnitt (unter BUG_OK) liest den 
aktuellen Status der Steuertafel und wandelt ihn wieder 
zurück in die Felder der globalen Datenstruktur Options. 
Gleichzeitig analysiert er (in einer zugegebenermaßen 
plumpen Weise) das Filter-Editierfeld und definiert eine 
Liste der akzeptierten Klassifizierungscodes für Debug- 
Zeilen. 

Schließlich erzeugt die Funktion Debug formatierte 
Debug-Zeilen. Sie wird üblicherweise von vielen Stellen der 
Anwendung aus aufgerufen. Der erste Parameter dieser 
Funktion ist der Zeilenklassifizierungscode, der von dem 
Filter-Abschnitt der Debug-Funktion verwendet wird. Wenn 
der Debug-Filter aktiviert ist, wird dieser Klassifizierungs- 
code mit einer Liste zu filternder Kategorien verglichen. 
Nur Meldungen mit Codes in dieser Liste werden angezeigt 
oder auf Diskette geschrieben. So kann man die Meldungen 
ausfiltern, an denen man nicht interessiert ist. 

Man kann zum Beispiel ganz willkürlich allen Zeichen- 
ereignissen eine 1, alle Zwischenablage-Ereignissen eine 2 
und allen anderen eine 3 zuordnen. Wenn man dann alle 
Zeilen bis auf die Zwischenablage- und Zeichenereignisse 
ausschließen will, würde man den Filter mit der Bereichs- 
angabe 1,2 aktivieren. Alle Zeilen, denen der Code 3 zuge- 
wiesen wurde, werden dann von der Anzeige im Fenster 
oder dem Protokoll in der Datei ausgeschlossen. So erhält 
man ein konzentriertes Ausführungsprofil, mit dem man 
sich auf die speziellen Bereiche eines Programms konzen- 
trieren kann, die einen interessieren. 

Der zweite Parameter der Debug-Funktion ist ein For- 
matsteuerstring, der den Inhalt der zu erzeugenden Zeile 
definiert. Dieser Steuerstring ist identisch mit dem, der in 
der Standard-C-Funktion printf verwendet wird. 


{ 


| /x 
| * DebugControl( hhnd ) 
# 


: BOOL FAR PASCAL 
* hund main application window handle 

# 

* This function enables the user to monitor and adjust the 

* a en panel settings. khen this function is called 
* 1 dialog box is displayed which allows the user to 

* set the debug options. 

# 


* The value returned indicates how the user terminated the 
dialog box - TRUE implies the OK button was pressed, FALSE 
the GANCEL button. 


x/ 


|BOOL FAR PASCAL DebugControl( hund ) 
HHND 


hund; 


/* local variables */ 
FARPROG 1pProc; fR Eenpocary function address #/ 
BOOL bResult; /* boolean result value *#/ 


HANDLE hInstance; /* window instance handle #/ 


/* retrieve instance handle */ 
hInstance = GetkindowkWord( hand, GWW_HINSTANCE }; 


/* display dialog box */ 

lpProc = MakeProcInstance( DebugControlDlgFn, hinstance ); 

bResult = DialogBox(hInstance, (LPSTR)"DebugControl”,huWnd, 
Proc); 

FreeProcInstance( 1pProc ); 


/* return final result */ 
return( bResult ); 


DebugControlDlgFn(hDlg wMsg,wParam,1Paran) : BOÖOL FAR PASCAL 
window handle 
dialog message 
word parameter 
]Param long parameter 
This function processes all the messages related to the 
debug control panel dialog box. With the dialog box the 
user can add, change, and remove debugging channels. 


/ 


# 
# 
# 
= 
# 
# 
# 
# 
# 
# 
* 
# 
# 


BOOL FAR PASCAL DebugControlDlgFni hDlg, wHsg, wParan, 1Param ) 





HWND hDlg; 
KORD wMsg; 
WORD wParan; 
LONG lParan; 


/* local variables #*/ 
BOOL bResult; 


/* initialization %* 
bResult = TRUE; 


/* boolean result variable */ 


/* process message */ 
switch( wAsg } 


case WM_INITDIALOG : /* initialize dialog box %/ 


{ 
/* local variables #*/ 
WORD L: 
int »Popup; 
int yPopup; 
int cxPopup; 
int cyPopup; 


/* loop variable */ 

/* popup x position #/ 

/* popup y position *#/ 

/* width of popup window #/ 
/* height of popup window */ 
RECT rectknd; /* temporary window rect *#/ 
char szToken[8#]; /* character token */ 

char szFilterList[64]; /* filter list string #/ 
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/* The following code centers the dialog box in the middle */ 
/* of the screen. It uses the dimensions of the display *#/ | 
/* and the dialog box and repositions the dialog box */ 
/* accordingly. */ 







/* retrieve popup rectangle */ 
GetWindowRect ( hDig, (LPRECT)&rectWnd ); 














/* calculate popup extents */ 
cxPopup = rec rg - rectknd.left; 
cyPopup = rectWnd.bottom - rectknd.top; 















/* calculate new location & move dialog box */ | 
xPopup = ( GetSystemMetries(SM_CXSCREEN) - cxPopup) /2; 
yPopup = ( GetSystemMetrics(SM_CYSCREEN) - cyPopup) /2; 







MoveWindow( hDlg, xPopup, yPopup, .c#Popup, cyPopup, 
TRUE) ; 


/* define filter list */ 
szFilterList[8] = 8; 
if ( Options.wFilterSize ) { 
sprintf( szFilterList, "#u", Options.Filter[#] ); 
for ( i=1; i<Options.wFilterSize; i++ ) { 
SpeAnEtN szToken, ",%u”, Options.Filter[i] ); 
strcat( szFilterList, szToken ); 
















} 


/* check ON-OFF radio buttons #/ 
CheckRadioButton( 

hDlg, 

BUG OFF, 

BUG ON, 
(Options.bActive) ? BUG_ON :BUG_OFF | 









/* define check boxes */ 
CheckDlgButton( hDlg, BUG _COUNT, Options.bCount ); 
CheckDlgButton( hDlg, BUG_DISPLAY, Options.bDisplay ); 
CheckDlgButton( hDlg, BUG_FILTER, Options.bFilter ); 
CheckDlgButton( hDlg, BUG_LOG, Options.bLog ); 








/* 00 filter categories & log file name */ 
SetDlgItemText( hblg, BUG FILTERLIST, szFilterList ); 
SetDlgltemText( hDlg, BUG LOGFILE, Options.szLogFfile ); 


/* disable check boxes & edit fields if debug 
inactive %/ | 
if ( !Options.bActive ) { 









/* disable check boxes #/ 
ENABLE( hDlg, BUG COUNT, FALSE ); 
ENABLE( hDlg, BUG DISPLAY, FALSE ); 
ENABLE{ hDlg, BUG FILTER, FALSE ); 
ENABLE( hD1g, BUG LOG, FALSE ); 







/* disable edit fields */ 
ENABLE( hDlg, BUG _FILTERLIST, FALSE ); 
ENABLE( hDlg, BUG LOGFILE, FALSE ); 


} else { 


/* enable edits field */ 

ENABLE( hDlg, BUG _FILTERLIST, 
IsD1 ButtonChöcked(hDlg, 
BUG FILTER) ); 

ENABLE( hDlg, BUG LOGFILE, 

IsDlgButtonChecked(hDlg, 

BUG LOG) ); 












) 


break; 
case WM COMMAND : /* dialog box command */ 
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Die Parameter, die auf diesen Steuerstring folgen, werden 
zusammen mit dem Format-Steuerstring verwendet, ent- 
sprechend umgewandelt und ausgegeben. Hier einige Bei- 
spiele, wie die Debug-Funktion aufgerufen werden kann: 








 "WM_SIZE: [%u,%u], LOWORD(1Param), 
HIWORD(1Param) ): 

"WM MOVE: [%u,%u]”, LOWORD(1Param), 
HIWORD(1Param)); 

"WM_CHAR: [%c,%u]”, wParam, wParam ); 


"WM_ACTIVATE: [%s]", (wParam)?"on":"off” ); 





Beachten Sie, wie die variable Anzahl Parameter von 
der Debug-Funktion gehandhabt wird. Solange Sie nicht die 
Größe der Struktur, die als Wert übergeben wird, ändern, 
sind Sie auf 64 Byte für die Parameterübergabe einge- 
schränkt. Sie werden vielleicht mit Alternativen zu dieser 
Art der Parameterübergabe experimentieren wollen. Eine 
Empfehlung meinerseits ist die Verwendung der C 5.x- 
Funktion vprintf mit den entsprechenden ANSI-C- oder 
UNIX-System V-Varianten. 


Einbau der Debug-Utility 


Bevor Sie die Tools der Debug-Utility verwenden können, 
um die interne Funktionsweise Ihrer Anwendung zu über- 
prüfen, müssen sie mehrere Schritte ausführen: 

Kopieren Sie die folgenden Dateien in das Verzeichnis, 
wo Sie Ihre Anwendung kompilieren: 

DEBUG.H 

DEBUG.C 

Definieren sie eine neue Compiler-Befehlszeilenvariable 
in der Make-Datei Ihrer Anwendung. Diese Variable kann 
dann mit #if-Anweisungen abgefragt und so der Debug- 
Code erzeugt werden. Sie können zum Beispiel folgende 
Compiler-Flags verwenden: 








STDFLAGS=-c -u -AS -Gsw -0s -Zep 
BUGFLAGS=-c -u -A5 -Gsw -Os -Zep -DDEBUG 
De anaon: bugtest.c 

cl $(BUGFLAGS) bugtest.c 





Ändern Sie die Make-Datei für Ihre Anwendung so, daß 
das Modul DEBUG.OBJ hinzugefügt wird, wenn Sie Ihr Pro- 
gramm erstellen. Andern Sie die Make-Datei zum Beispiel 
von 


bugtest.exe: De bugtest.def bugtest.res 
link4 bugtest /AL:16 /NÜE, , ‚slibw, bugtest.def 


bugtest.exe: bugtest.obj eo bugtest.def bugtest.res 
link4 bugtest+debug /AL:16 /NOE,,‚slibw,bugtest.def 





Definieren Sie eine Nummer für die Debug-Kontroll- 
meldung in der Header-Datei Ihrer Anwendung. Diese 


Windows 





Meldung wird von Windows übergeben, wenn Sie im 
Systemmenü Debug auswählen. 

Exportieren Sie DebugControlDlgFn indem Sie die 
Funktion in der DEF-Datei Ihrer Anwendung angeben. 
Wenn Sie das nicht tun, führt dies zu fehlerhaftem Verhal- 
ten. Sie können den Export-Abschnitt der DEF-Datei zum 
Beispiel von 


XPORTS 
TestWndFN @1 


EXPORTS 
TestWndFN @1 
DebugControlDlgFn @2 


ändern. 

Fügen Sie die markierten Zeilen aus Listing 6 in die 
Ressourcendatei Ihrer Anwendung ein. 

Rufen Sie in Ihrem Programm die Funktion Debug- 
Setup kurz nach der Anlage des Hauptfensters auf. Ver- 
gewissern Sie sich, daß das Hauptfenster ein Systemmenü 
hat und der Funktion eine gültige Handle übergeben wird. 
Es ist guter Programmierstil, diesen Funktionsaufruf in eine 
Bedingung zu stellen: 


if DEBUG 
ap hMainWnd, BUG_CONTROL, 188); 


Zendi 


Verwenden Sie die Anweisung #include "debug.h" 
in jeder Quelldatei, in der Sie Routinen der Debug-Utility 
verwenden. Die Header-Datei enthält Funktionsdefinitio- 
nen und Aufrufkonventionen, die diese Routinen benötigen. 

Schreiben Sie in Ihr Programm an interessanten Stellen 
Debug-Anweisungen. Versuchen Sie, Ihre Debug-Anwei- 
sungen in Kategorien einzuteilen. 

Beachten Sie, daß das Debuggen standardmäßig ausge- 
schaltet ist (OFF) und Anweisungen, die auftreten, bevor 
die Utility aktiviert wird, ignoriert werden. Ein Beispiel für 
diese Verwendung ist der Einsatz von Debug-Anweisungen, 
um die Verarbeitung der Meldungen für die Anlage des 
Fensters in der Hauptfensterfunktion Ihrer Anwendung zu 
überwachen. 

Kompilieren und linken Sie Ihre Anwendung neu. 





BUGTEST Make-Datei 


BUGTEST.C Quellcode 
BUGTEST.RC Ressourcen-Datei 


BUGTEST.ICO Sinnbild 

BUGTEST.DEF Moduldefinitionsdatei 

Tabelle 1: Eine Liste der Dateien, die für das Beispielpro- 
gramm benötigt werden, das die Debug-Utility verwendet, 








/* process sub-message */ 
switch( wParam ) 


case BUG. ON : /* turn debug on #/ 


/* redefine radio button #/ 
BETEN SNETOR! hDlg, BUG OFF, BUG_ON, 
UG_ON ); 


/* Erbl check boxes #/ 
ENABLE( hDlg, BUG COUNT, TRUE }; 
ENABLE( hDig, BUG_DISPLÄY, TRUE ); 
ENABLE( hDlg, BUG FILTER, TRUE ); 
ENABLE( hDlg, BUG LOG, TRUE ); 


/* enable edits field */ 
ENABLE( hDlg, BUG FILTERLIST 

IsD1 Buß boncheckedihDig, "BUG FILTER) 
ENABLE( 18: BUG LOGFIL 

IsD1gBu EonchackedihDig, BUG LOG) ); 


break; 
case BUG | OFF : /* turn debug off */ 


/* redefine radio button */ 
- CheckRadioButton( hDlg, BUG_OFF, BUG_ON, BUG_OFF ); 


/* enable check boxes */ 

ENABLE( hDlg, BUG_COUNT, FALSE ); 
ENABLE( hDlg, BUG | "DISPLAY, FALSE ); 
ENABLE( hDlg, BUG_ _ FILTER, FALSE ); 
ENABLE( hDlg, BUG LOG, FALSE ); 


/* enable edit fields */ 
ENABLE( hDlg, BUG_FILTERLIST, FALSE ); 
ENABLE( hDlg, BUG LOGFILE, FALSE ); 


break; 
case BUG COUNT : /* count debug events */ 
TOGGLE ( hDlg, BUG COUNT ); 


break; 
case BUG DISPLAY : /* dis lay debug events #/ 
TOGGLE( hDlg, BUG DISPLAY ); 
break; 
case BUG FILTER : /* filter debug events */ 
TOGGLE ( hDlg, BUG _FILTER }; 
ENABLE( hDlg, BUG FILTERLIST, 
IsDlg tonChecked(hDlg, 
BUG_FILTER) ); 
break; 
case BUG LOG : /* log debug events #/ 
TOGGLE ( hDlg, BUG LOG !: 
ENABLE( hDle BUG LOGFILE, 
a aeilnng, 
BUG | 
break; 
case BUG_OK : /* done with debug control panel */ 


{ 


/* local variables */ 


1: 
char "sp Token; 
char  szTloken[®]; 
char szCa tionL64]; 
char szFilterList[32]; 


/* capture radio button state */ 
Options.bActive = 
IsDlgButtonChecked( hDlg, BUG_ON ); 


/* capture check box states */ 
BC Kar) „beount = IsDlgButtonChecked( hDlg, 


Opelons up ‚olsplay-IsDigßuttonchecked(hlg 
BUG _DISPL 
nen hPitler=IsDigButtonchecked 
( hDig,BUG FILTER); 
BbG 100 ‚bLog = IsDigButtonChecked( hDlg, 
LOG ); 
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/% er filter list changes - no limit 
checking! * 
an emText( 


BUGEFILTERLIST, 
szFilterList, 
sizeof(szFilterList) 








Y; 


Options.wFilterSize = 8; 
spToken = strtok( szFilterList, 
ile ( spToken ) { 
Options.Filter 
[ Options.wFilterSize++ ] = atoi 
( spToken ); 
spToken = strtok( NULL, " „;" 3; 










ed 








file changes #/ 





/* capture lo 
GetDleltenText( 







IB, 
BUG LOGFILE, 
OptIons. szLogFile, | 
sizeof(Options. szLogFile) 






); 


/* display listbox if necessary */ 
if ( Options.bActive ) { 











/* update viewport window 
caption */ 

if ( Options.bFilter && 
Options.wFilterSize ) { 


/* define filter ur #/ 
szFilterList[#] = 
if ( Options. rilteiSize It 
sprintf 
( szFilterList, "Ru", 
Options.Filter[8] ); 
for ( i=]; 
i<Options. 
wFilter$Size; i++ ) { 
a szToken, 
Options.Filter[i] ); 
strcat( szFilterList, 
s2Token ); 



















sprintf( 
szCaption, 
"es ‚Er (#5)", 
Options.szLogFile, 
szFilterList 







}; 


} else 
ag szlaption, 
" 5 - 











(ALL}”, 





Options.szLogFile ); 





/* define caption & make window 

visible #/ 

SER IDIERE Options.hListBox, 
tion ); 

Sho Hindouf Options. hListBox, 

SHOW _OPENWINDOR ); 












} else 
showWindow( Options.hListBox, 
HIDE_WINDOR ); 

/®* exit #*/ 

EndDialog( hDlg, TRUE ); 
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Debug Test Window 
Alt+F5 
ALr+F? 
ALt+FR 
Alt+F9 
Alt+F10 


Schließen Alr#+F4 
pe | 


Kiederherstellen 
Bewegen 

Größe ändern 
Sinnbild 


Bild 3: Das Testfenster für die Debug-Utility. Die Option 
Debug ıst zum Systemmenü hinzugefügt worden. 


Benutzung der Debug-Utility 


Damit Sie die Debug-Utility so gut wie möglich verstehen, 
wollen wir uns ihren Einsatz einmal in einer Beispielanwen- 
dung wie BUGTEST.EXE ansehen (Listings 3 bis 6). In den 
Listings sind die Zeilen, in denen die Debug-Utility verwen- 
det wird, hervorgehoben. Sie können diese Hervorhebungen 
als Vorlage für den Einbau der Utility in Ihr eigenes Pro- 
gramm verwenden. 

Achten Sie besonders auf TestWndFn in BUGTEST.C. 
Diese Fensterfunktion enthält mehrere explizite Verweise 
auf die Debug-Utility. Zunächst sehen Sie eine Reihe von 
Debug-Anweisungen, die den Inhalt mehrerer Windows- 
Meldungen ausgeben. Sehen Sie sich an, wie die Meldungen 
klassifiziert werden und erinnern Sie sich daran, daß Sie 
Kategorien herausfiltern können, um die Generierung von 
Debug-Zeilen zu begrenzen. 

Sie sollten sich auch die Sonderbehandlung der Meldung 
BUG CONTROL bei der Bearbeitung der Meldung 
WM_SYSCOMMAND genau ansehen. Diese Meldung wird 
erzeugt, wenn Sie im Systemmenü Debug auswählen. Durch 
den Aufruf von DebugControl wird die Steuertafel von 
Debug angezeigt, mit der Sie das Debuggen ein- und aus- 
schalten und verschiedene Ausgabeoptionen einstellen kön- 
nen. 

Um BUGTEST.EXE zu erzeugen benötigen Sie Micro- 
soft C 5.0 oder 5.1, Windows 2.03 und das Windows 2.03 
Software Development Kit (SDK). Wenn Sie das SDK für 
2.03 nıcht haben, können Sie das Programm (mit eventuel- 
len kleinen Korrekturen) auch mit dem 1.04 SDK zum 
Laufen bringen. Das Sinnbild BUGTEST.ICO ist nicht abge- 
bildet, Sie können sich jedoch ein beliebiges Sinnbild mit 
IconEdit selbst erstellen. (Alle Dateien für DEBUG und 
BUGTEST sind wie immer auch auf der Microsoft System 
Journal-Diskette erhältlich.) 


BUGTEST.LOG - 
7? WHLPAINT: j 
WH_HOVE: [15,0] 
WA_LSIZE: [335,640] 
0 NT: 


in 
act 
3 WM_MOUE: [313,42] 
24 WH_SIZE: [36,36] N 
WH_ACTIUATE: inactrivare 
WH_AETIVUATE: activate 


„MOVE: [30,16] 
SI2ZE: [134,304] 





Bild 4: Die Listenbox von BUGTEST. 


Wenn Sıe die Anwendung BugTest erstellt haben, soll- 
ten Sie ein wenig mit der Debug-Utility herumexperimen- 
tieren. Wenn Sie das Programm zum ersten Mal starten, 
erscheint ein Standardfenster. Mit der Maus oder der 
Tastatur können Sie dieses Fenster verschieben, seine 
Größe verändern oder es in ein Sinnbild verwandeln, genau- 
so wie bei jedem anderen Fenster (Bild 3). Immer wenn Sie 
eine dieser Operationen ausführen, werden zahlreiche 
Debug-Zeilen erzeugt, sie werden von der Debug-Utility 
jedoch ignoriert, bis Sie das Debuggen mit der Steuertafel 
explizit einschalten (ON). 

Um auf die Steuertafel zuzugreifen, wählen Sie Debug 
im Systemmenü. In dieser Dialogbox können sie das Debug- 
gen einschalten und Optionen angeben. Sie können die 
Optionen Count und Display aktivieren, wodurch die 
Debug-Zeilen numeriert und die Ergebnisse in der Listen- 
box angezeigt werden (Bild 4). In dieser Listenbox können 
Sie sich die Debugzeilen ansehen, während Sie von der 
Hauptanwendung erzeugt werden (Bild 5). 

Denken Sie daran, daß Sie mit der Filter-Option 
bestimmte Kategorien von Debug-Zeilen auswählen kön- 
nen. Beachten Sie auch, daß diese Version der Debug-Uti- 
lity auf 32 Filter-Kategorien eingestellt ist. Wenn dies nicht 
ausreicht, können Sie einfach die Definition von 
MAX_FILTER in DEBUG.C auf einen größeren Wert abän- 
dern und die Utility neu kompilieren. 

Die Option Log-File funktioniert ähnlich wie die Dis- 
play-Option, nur werden die Debug-Zeilen dann an die 
Datei angehängt, die Sie angeben. Sie können sich die 
Debug-Zeilen gleichzeitig anzeigen und in der Datei proto- 
kollieren lassen, das System wird dadurch jedoch erheblich 
langsamer. Wenn ich Protokoll-Dateien verwende, füge ich 
folgende Zeile in den Extension-Abschnitt von WIN.INI 
ein: 


LOG=NOTIZ.EXE *.LOG 





case BUG CANCEL : /* cancel control panel */ 
case IDCÄNGEL : 

EndDialog({ hDlg, FALSE ); 

break; 
default : /* ignore all others #/ 

bResult = FALSE; 

break; 


break; 

default : 
bResult = FALSE; 
break; 


/* return final result #/ 
return( bResult ); 


* Debug( wCategory, ParmList) : BOOL FAR 


wCategory debug message classification 
ParaList debug parameter list 


* This function outputs a formatted Krete to the debug 

* utility routines. The wCategory variable determines how 

* the message is filtered. The Paralist is a standard printf 
* parameter list. A value of TRUE 15 returned if the message 


| * was successfully processed and not filtered. 
# 


* Note that this function CANNOT be declared of type PASCAL 

* as it uses a variable number of arguments! Also note that 
alternative methods are available for handling a variable 
number of function paraneters. 


*/ 
BOOL FAR Debug( wCategory, ParmList ) 
WORD 


wCategory; 
struct { 


char cBytes[64]; 
} Paralist; 


/* local variables *#/ 

WORD ; /* temporary loop variable */ 
int hFile; /* log file handle */ 

BOOL bResult; /* result of function %/ 

BOOL biInclude; /* include hen flag */ 
char  szStatement[132]; /* temporary statement, */ 


/* initialization */ 
bResult = FALSE; 


/* process statement if debug active */ 
if ( Options.bSetup && Options.bActive ) { 


bInclude = TRUE; 


/* check for inclusion in filter list #/ 
if ( Options.bFilter ) { 


/* search filter list #/ 

for ( 
i=B; 
(i<XOptions.wFilterSize)&& 
(Options.Filter[i]t= 
wCategory); 
i+ 


HE 
/* turn off include if not found */ 
if ( i >= Options.wFilterSize ) 
bInclude = FALSE; 
} 


/* format debug statement if included %/ 
if ( bInclude ) { 
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“ Paare for debug statement */ 


bResuit = TRUE; 
Options. INsgCount++; 


/* define debug statement */ 
if ( Options.bCount ) 
i = sprintf( szStatement, "ld ", 
Options.1MsgCount ); 
i += sprintf( &szStatement[li], Parmlist ); 













/* display debug statement in listbox */ 
if ( Options.bDisplay ) { 






/* Note: since we are passing 
* the formatted debugging 

* statement to the listbox using 
* a SendMessage we cannot do 

* anything which would cause 

* memory to be shuffled - this 


* invalidates the pointer! 
#/ 












/* add new statement to listbox */ 
SendMessage( 
tions.hListBox, 
ADDSTRING, 
(WÖRD)®, 
(LONG) (LPSTR)szStatenent 









); 


/* remove first statement from 
listbox if necessary */ 
if ( Options.wEntries >= 
Ontions.wMaxEntries ) { 
SendMessage ( 
ptions.hListBox, 
} _DELETESTRING, 
(LONG) 
























} else 
Options .wEntriest+; 






/* make last statement visible */ 
SendMessage( 
tions.hListBox, 
LB SETCURSEL, 
(HÖRD)Options. wEntries-1, 
(LONG) 









5 


% 






} 


/* output ee ERS hen to logfile */ 
if ( Options.bLog 






/* open or create log file */ 
hFile = open( Options.szLogFile, 
MODE _APPEND, SHARED); 

if (hfile<8) 

hFile=o open(options „szLogFile, 
MODE_CREATE, SHARED); 








/* write message to file if 
sucessful # MY) 

if (hFfile>d) { 
write( hFile, szStatement, i ); 
write( hFile, "\r\n”, 2 ); 

close( hFile ); 











} 


/* return result #/ 
return( bResult }; 






Listing 2: Die Debug-Utility. 
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— BEE ©... .; SE 2: 3 ©! 


BUGTEST.LOG - 
AIHT: 


AIHT: 
TIUATE: activate 
Aeen [190,440] 


Bild 5: /n der Listenbox werden die Debug-Zeilen angezeigt. 


Dadurch kann ich mir eine Protokolldatei mit einem 
Doppelklick auf ihren Namen vom Notizbuch anzeigen las- 
sen. Denken Sie aber daran, daß dieses Programm keine 
großen Protokolldateien laden kann, doch das sollte eigent- 
lich kein großes Problem sein. 

Die Debug-Utility wird sicherlich nicht solche Pro- 
gramme wie Windows-CodeView verdrängen. Doch für ein- 
faches Debuggen bietet sie viel Übersicht über die Funk- 
tionsweise eines Programms und dürfte deshalb eine nütz- 
liche Erweiterung der Toolbox jedes Programmierers sein. 

Mit der Debug-Utility können eine ganze Reihe von 
Windows-Problemen gelöst werden. Mit den Listings auf 
diesen Seiten als Ausgangspunkt können Sie diese Utility in 
vielen interessanten Bereichen ausbauen. Sie können sich in 
das System einklinken, um eine allgemeine Meldungsüber- 
wachung durchzuführen und so Probleme zwischen Anwen- 
dungen aufzuspüren. Sie können auch mit mehreren 
Debug-Fenstern für eine Anwendung experimentieren. 
Oder Sie könnten die Utility in eine dynamische Link- 
bibliothek bringen und mehrere Anwendungen gleichzeitig 
testen. Diese und hoffentlich viele weitere kreative Erweite- 


rungen überlasse ıch Ihnen. 
Kevin P. Welch 


STDFLAGS=-c -u -AS -Gsw -O5 -Zep 
BUGFLAGS=-c -u -AS -Gsw -Os -Zep -DDEBUG 


bugtest.res: bugtest.rc bugtest.ico 
re -r bugtest.rc 


astie; obj: ak: ‚h debug.c 
el $(STDFLAGS) debug.c 


bugtest.obj: ee 


cl $(BUGFLA 


bugtest.exe: bugtest.obj bugtest.def bugtest.res debug.obj | 
link4 bugtest+debug /AL:16 /NOE,,,‚slibw slibcew,bugtest.def 
rc bugtest.res 


$) bugtest.c 





Listing 3: Die Make-Datei BUGTEST. 


/* 
* DEBUG TEST PROGRAM - SOURCE CODE 
# 


* LANGUAGE : Microsoft C 5.8 

* MODEL : small 

* STATUS : operational 

Ei 

* 12/11/87 1.89 - Kevin P. Welch - initial creation. 
1.3 


# 

Zinclude <windows.h> 
include "debug.h" 

/* local definitions %*/ 


/define BUG CONTROL 281 


/* function definitions */ 
LONG FAR PASCAL TestkWndFfn( HWND, WORD, WORD, LONG ); 


* 
| * MAINLINE - BUG TEST PROGRAM 
# 


* This mainline initializes the test program and processes 


* and dispatches all messages relating to the debug test 
* window. 
#* 


*/ 


int PASCAL KinMain( hInstance, hPrevInstance, lpsCnd, wCndShow 


) 
HANDELE hinstance; 
HANDLE hPrevInstance; 
LPSTR IpsCod; 
WORD wCndShow; 


/* local variables #/ 
MSG Msg; /* current system message */ 


/* initialization %/ 


if (TestInit(hInstance, hPrevInstance, lpsCmd, wCndShow )) 


ee system we until ae */ 

It e ( GetMessage( (LP ne ana ei 
TranslateMessage( (LPMSG)&Msg 
DispatchMessage( (LPUSG)AMSE" ei 


/* terninate application */ 
exit( Msg.wParam ); 


else 
exit( FALSE ); 


TestInit(hInstance,hPrevInstance, 1psCnd,wCndShow) : BOOL 


# 
* 
u. hInstance current instance handle 
% hPrevInstance handle to previous instance 
x IpsCnd command line string 

% dShow window display flag 

# 


* This utility function perforas all the initialization 

# BE as for testing the debug utility. Included in this 
„Drog gram is the registry and creation of the main window & 
he installation of the debug utility code. 


* 
* 








static BOOL TestInit(hInstance,hPrevInstance, lpsCmd, wCmdShow) 


HANDLE hInstance; 
HANDLE hPrevInstance; 
LPSTR lpsCad; 

WORD wCndShow; 


/* local variables #/ 
HWND nd; 


hhnd; /* current window handle */ 
BOOL bResult; /* result of initialization #/ 
WNDCLASS MHndllass; /#* window class %*/ 


/* initialization */ 
bResult = FALSE; 


/* register window class %/ 
if ( !hPrevInstance ) { 


/* define window class #/ 

menset( &hWndGlass, 9, sizeof(WNDCLASS) ); 

WndClass. lpszClassNane = (LPSTR)"Testhindow"; 
WndClass.hCursor = LoadCursor( NULL, IDC_ARRON ); 
WndClass.1pszMenuName = (LPSTR)NULL; 

KndClass.style = CS_HREDRAR | CS_ VREDRAH; 
WndClass.lpfnkndProc = TestkndFn; 

KndClass.hInstance = hiInstäance; 

KndClass.hlcon = LoadIcon( hinstance, "BueTestIcon” ); 
WndClass.hbrBackground = (HBRUSH) (COLOR_MENU + 1); 


/* register maze window class */ 
if ( RegisterClass( (LPWNDCLASS)&WndClass ) ) { 


/* create window %*/ 

hHnd = CreateWindow( 
"TestWindow”, /* class name #/ 
"Debug Test Window”,/* caption #/ 
WS TILEDWINDOW, /* style #/ 
CW USEDEFAULT, /* x position #/ 
CH USEDEFAULT, /* y position #/ 
Ch USEDEFAULT, /* width */ 
CW USEDEFAULT, /* height */ 
(HHND)NULL, /* parent window #/ 
(HMENU)NULL, I menu %/ 
hInstance, ken */ 
(LPSTR)NULL je other data */ 


* 
’ 


/* continue if successful */ 
if ( hund I { 


/* Here is where the debug utility is 
‘ installed into the program. A response 
message number is provided along with the 
maximum number of debug statements which 
' will be maintained by the listbox. The 
this number, the less global memory 
vallable for your application. 


|#if DEBUG 
/endif 


DebugSetup( hund, BUG CONTROL, 188 ); 


/* nake window visible #/ 
bResult = TRUE; 
Showkindowt hind, wCndShow ); 


} 


} 


/* return result */ 
return( bResult ); 
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|/* 
* TEST WINDOW MESSAGE PROCESSING PROCEDURE 


# 


TestWndfni{hWnd, wMessage, wParan, lParam } : LONG FAR PASCAL 


hknd window handle 

wMessage message number 

wParam additional message information 
lParam additional message information 


* This window function processes all the messages related to 
* the GERUE test window, Using the system menu the user can 
* display the debug control panel dialog box. 

* 


#/ 


LONG FAR PASCAL TestkndFn( hund, wMessage, wParan, lParanm ) 
HWND hund; 
Message; 
Param; 
lParam; 


/* local variables */ 
LONG lResult; 


/* initialization #/ 
lResult = FALSE; 


#if DEBUG 
/* sample debugging output #/ 
switch( Base ) 
case WM MOVE : 


Debug( 1, "WMMOVE: [Xu,%u]", HIWORD(1Paran), 
LOWORD(1Paran) }; 


/* result of message */ 


break; 
case WM SIZE : 


DEBuEN 1, "WM_SIZE: [%u,%u]", HIWORD(1Paranm), 
LOWORD(1Param) ); 


break; 
case WM CHAR : 


break; | 
case WM ACTIVATE : 


Debug( 3, "WM_ACTIVATE: %s", 
(wParan)?"actIvate”:"inactivate” ); 


Debug( 3, "WM ACTIVATEAPP: %s”, 
(wParam)?"actIvate”:"inactivate” ); 


break; 
case WM_PAINT : 
Debug( 4, 
break; 
default : 
break; 
Zendif 


/* process each message */ 
swi EN wMessage ) 


case WM SYSCOMMAND : /* system command %/ 
/* In here you need to handle the special case where 


* the user asks for the debug control panel to be 
* displayed. 
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* To do so you need to trap the control panel response 
* message you provided when installing the debug 
* utility. 


#/ 


/* process sub-message */ 
N wParam ) 


/if DEBUG 
case BUG CONTROL : /* debug control panel */ 
DebugControl( hund ); 
break; 


default : 
lResult = DefWindowProc( hWnd, wMessage, wParam, 
lParan ); 
break; 


break; 

case WM DESTROY : /* destroy window %/ 
PostQuitMessage( # ); 
break; 

default : /* send to default */ 
lResult = DefkindowProc( hkHnd, wMessage, wParan, 
lParam ); 
break; 


/* return normal result */ 
return( 1lResult ); 





Listing 4: Das Beispielprogramm BUGTEST.C. 


NAME BUGTEST 
| DESCRIPTION "Debug Test Utility’ 
| STUB "WINSTUB.EXE’ 


CODE MOVEABLE 
DATA MOVEABLE MULTIPLE 


HEAPSIZE 4096 
STACKSIZE 48996 


EXPORTS 
TestkndFn 





_ DebugControlDlgfn @2 


Listing 5: Die Moduldefinitionsdatei BUGTEST.DEF. 


DEBUG TEST PROGRAM - RESOURCE FILE 


LANGUAGE : Microsoft C 5.8 
* MODEL : small 
* STATUS : operational 
# 


* 12/11/87 1.890 - Kevin P. Welch - initial creation. 
# 
“ 


#include <style.h> 
include "debug.h” 


BugTestlIcon ICON bugtest.ico 





Windows Termine 





Termine ... Termine 


Microsoft Excel für Programmierer 


Debu Control DIALOG LOADONCALL MOVEABLE DISCARDABLE 8,28,185,81 Das dreitägige Seminar wendet sich an PC-Software- 
ee = ne | RS. DILGFRANE 1: Ks. Popup Re die a in einer höheren 
Sr S rogrammiersprache haben. 
BUG.OFF, "bötton® SID’ RADIO, 5, 3, 138, 12 „Die Teilnehmer lernen im Vortrag und in praktischen 
Eu. ON. "httonn. SD. a men Übungen am PC das Konzept und die Möglichkeiten, mit 
can debug events." Microsoft Excel-Makros Applikationen zu erstellen. 
BUG COUNT, "button", STD CHECKBOX, 18, 26, 114, 12 
"&Display in debu window. ® | Br. 
ae "but Ba ‚ STD Sr 18, 38, 114,12 Ort Datum Veranstalter 
ag ILTER, "button", STD_CHECKBOX, 18, 58, 34, 12 | Disseldorf 19./20./21.09. OBZ 
ur FILTERLIST, "edit”, STD_EDITFIELD, 55, 58, 78, 12 17./18./19.10. OBZ 
ELo | / | 
BUG_ eo "button”, STD_CHECKBOX, 18, 62, 36, 2 28./29./30.11. OBZ 
CONTROL ' München 10./11./12.10. Integrata 
Ali BUG LOGFILE, "edit", STD_EDITFIELD , 55, 63, 78, 12 Münster 12./13./14.12. Integrata 
et N, "static”, STD FRAME, 142, 8, 1, 81 ar 05, En Integrata 
| n R Gen 05./06./07.12. Electro Calcul 
CONTROL ne HABLNET DEE ZBIITIUN RB, 420 2 Lausanne 24./25./26.10. Electro Calcul 
BUG_CANCEL, "button", STD_BUTTON, 148, 21, 32,14 | Wien 12./13./14.09. Ueberreuter 


07./08./09.11. Ueberreuter 
05./06./07.12. Ueberreuter 





Listing 6: Die Ressourcendatei BUGTEST.RC. 


Inserentenverzeichnis 


DB _ Microsoft Presentation Manager für Windows 
BKS Software 35 





BSP Krug 7 Programmierer 
| Dr.-Ing. P. Christiani 57 
ESM 27 
IE NERAE 3 Ort Datum Veranstalter 
Mannesmann Tally 21 
Markt & Technik Buchverlag 77,92 ir Ä 
Microsoft 40/41, 58/59 Düsseldorf en er 
Nokia Data 2 ‚il. 
| Star Division 11 19.12.88 OBZ 
|te-wi Verlag 17 Wien 20.10.88 Ueberreuter 
Geile 5 21.11.88 Ueberreuter 
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Termine ... lermine ... Termine ... lermine 


Mit Microsoft-Seminaren sicher in die Zukunft Ort Datum Veranstalter 
Das Betriebssystem der Zukunft heißt Microsoft OS/2. Düsseldorf 05./06.09. OBZ 
Microsoft Windows und der Presentation Manager sind die 03./04.10. OBZ 
Benutzeroberflächen der Zukunft sein. Für professionelle 07./08.11. OBZ 
Entwickler bedeutet das, sich ab sofort mit dieser neuen 05./06.12. OBE 
Software auseinandersetzen zu müssen. Damit schaffen sie , 
die Voraussetzung, schnellstmöglich Programme in der FEaERR een an 
»neuen Welt« verfügbar zu haben. 05. /06. 1. Integrata 

Natürlich wird die Umstellung auf das neue Betriebs- 
system sowie die Programmerstellung nicht von heute auf Hamburg 03./04.10. Integrata 
morgen vollzogen sein. Um den Anfang jedoch so einfach 12./13.12. Integrata 
wie möglich zu gestalten, bietet Microsoft eine Dienstlei- 
stung an: Das Microsoft Institut. München 12./13.09. Intel 
Die Spezialseminare des Microsoft Instituts vermitteln 15./16.09. Integrata 
in kleinen Gruppen intensiv all das, was zum Einstieg in die m eg iR ar 
Programmentwicklung nötig ist. Modernste Trainings- er 212. ne a 
methoden sowie PC-Demonstrationen und -Übungen sind Dan. Eu 
selbstverständlich. Die Dozenten befassen sich auch im PEt- Münster 19./20.09. Integrata 
sönlichen Gespräch ausführlich mit den individuellen For- 28./29.11. Integrata 
derungen und Problemen der Teilnehmer. So bekommen | 
professionelle Entwickler durch professionelle Schulung die Tübingen 26./27.09. Integrata 
Möglichkeit, ihren hohen Wissenstand den neuen Gegeben- 10./11.10. Integrata 
heiten anzupassen. 07./08.11. Integrata 
Jeder Interessent in der Bundesrepublik Deutschland, 21./22.11. Integrata 
der Schweiz und Österreich hat die Chance, sich mit der 
neuen Welt von Microsoft OS/2 und Microsoft Windows Graz 15./16.09. Ueberreuter 
auseinanderzusetzen. Denn das Microsoft Institut arbeitet 
vor Ort mit kompetenten Schulungsunternehmen zusam- Iausbruck 2,0. MeBerENMeE 
men: 7 081 
Digicomp AG, Zürich Linz 07./08.11. Ueberreuter 
Elektro-Calcul PI S.A., Lausanne Salzburg 13./14.10. Ueberreuter 
Integrata GmbH, Tübingen 
INTEL Semiconductor GmbH, München Wien 15./16.09. Ueberreuter 
Olivetti Bildungs-Zentrum GmbH, Düsseldorf 19./20.09. Ueberreuter 
Ueberreuter Media GmbH, Wien. 05./06.10. Ueberreuter 
f | | 29./3%0.11. Ueberreuter 
Die Dozenten werden speziell von Microsoft ausgebildet 
und stehen in ständigem Kontakt mit uns. So gibt es keine Genf 14./15.09. Electro Calcul 
Informationsverluste: Das Wissen wird immer aktuell und 
aus erster Hand vermittelt. Microsoft erstellt die Seminare Lausanne 14,/15.11. Electro Calcul 
und die Seminarunterlagen und gewährleistet Qualität 
durch die Auswertung der Seminare. Zürich 21./22.09. Digicomp 
13./14.10. Digicomp 
01./02.12. Digicomp 
Das Microsoft OS/2 Einführungs-Seminar 20./21.12. Digicomp 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 

Die Teilnehmer lernen im Vortrag und in Diskussionen 
das Konzept von Microsoft OS/2 kennen und erhalten 
einen Überblick über die Fähigkeiten und Programmier- 
schnittstellen dieses Betriebssystems. Während des 
Seminars haben die Teilnehmer die Möglichkeit, das 
Gelernte anhand von Übungsaufgaben für sich selbst zu 
überprüfen. 
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Der Microsoft OS/2 Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in einer höheren, 
strukturierten Programmiersprache unter MS-DOS und C- 
Kenntnisse besitzen sowie das MS-OS/2-Einführungssemi- 
nar besucht haben. 

Die Teilnehmer lernen im Vortrag und praktischen 
Übungen am PC Family-API-Programme zu schreiben und 


Termine 





“ © u [ 
Termine ... Termine ... Termine ... Termine 
Device-I/O-Routinen zu erstellen sowie Multitasking-Funk- Ort Datum Veranstalter 
tionen zu nutzen und eigene Dynamic-Link-Bibliotheken ZU fünchen 14./15.11. Integrata 
erstellen; außerdem können sie die erweiterten Speicherver- 05./06.12. Integrata 
waltungsmöglichkeiten des Intel 80286 nutzen und mit Hilfe 19./20.12. Integrata 
des MS-OS/2 Memory Managers programmieren. Dieses Münster 21./22.11. Integrata 
Seminar ist übrigens nicht im SDK-Preis enthalten. Tübingen 19./20.09. Integrata 

20./21.10. Integrata 
Ort Datum Veranstalter 03./04.11. Integer nn 
Düsseldorf 07./08./09.09.  OBZ 28./29.11. Integrata 
05./06./07.10. OBZ 21./ 2.2, Integrata 
09./10./11.11. OBZ Graz 26./27.09. Ueberreuter 
07./08./09.12. OBZ Innsbruck 05./06.09. Ueberreuter 
Frankfurt 07./08./09.09.  Integrata Lausanne 03./04.10. Electro Calcul 
07./08./09.12.  Integrata Linz 17./18.10. Ueberreuter 
Hamburg 05./06./07.10. Integrata Salzburg 28./29.11. Ueberreuter 
14./15./16.12. _Integrata Wien 03./04.10. Ueberreuter 
München 31./01./02.09. Integrata 14./15.11. Ueberreuter 
14./15./16.09. Intel Zürich 21./22.09. Digicomp 
21./22./23.09.  OBZ 10./11.11. Digicomp 
26./27./28.10. Integrata 05./06.12. Digicomp 
21./22./23.12. Integrata 
Münster 21./22./23.09. Integrata 
30./01./02.12. Integrata 
Tübingen 28./29./30.09. Integrata 
09./10./11.11. Integrata 
Genf 26./27./28.09. Electro Calcul a . ce 
Lausanne een Electro Calcul Der Microsoft Windows Workshop 
Wien 05./06./07.09.  Ueberreuter Das dreitägige Seminar wendet sich an PC-Software-Ent- 
17./18./19.10. _ Ueberreuter wickler, die Programmiererfahrungen in einer höheren, 
= 14./15./16.12. Ueberreuter strukturierten Programmiersprache unter MS-DOS und C- 
au een Kenntnisse besitzen sowie das Microsoft Windows Einfüh- 
12. 713. m 4 12. Diele rungsseminar besucht haben. 


Das Microsoft Windows Einführungs-Seminar 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 

Die Teilnehmer lernen im Vortrag und in Diskussionen 
das Konzept von Microsoft Windows kennen und erhalten 


Die Teilnehmer lernen im Vortrag und praktischen 
Übungen am PC Benutzerschnittstellen zu erstellen, die 
grafische Programmierschnittstelle zu nutzen, die Routinen 
zum Memory Management anzuwenden und dynamische 
Bibliotheken zu erstellen und zu benutzen. Dieses Seminar 
ist nicht im SDK-Preis enthalten, 


einen Überblick über dessen Fähigkeiten und Program- Ort Datum Veranstalter 
mierschnittstellen. Dieses Seminar ist nicht im SDK-Preis Düsseldorf 14./15./16.09. OBZ 
enthalten. 12./13./14.10.  OBZ 
| ’ 23./24./25.11. OBZ 
Ort Datum Veranstalter en OBZ 
Düsseldorf 12./13.09. OBZ Frankfurt 14./15./16.12. Integrata 
10./11.10. OBZ Hamburg 14./15./16.09. Integrata 
21.722211. OBZ 26./27./28.10. Integrata 
12./13.12. OBZ München 07./08./09.12. Integrata 
Frankfurt 06./07.10. Integrata Münster 23./24./25.11. Integrata 
Hamburg 12./13.09. Integrata Tübingen 21./22./23.09. Integrata 
10./11.10. Integrata 30./01./02.12. Integrata 
24./25.10. Integrata Lausanne 05./06./07.10. Electro Calcul 
München 01./02.09. Integrata Wien 10./11./12.10. Ueberreuter 
26./27.09. Integrata Zürich 26./27./28.09. Digicomp 
13./14.10. Integrata 28./29./30.11. Digicomp 
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Fragen & Antworten 





Fragen & Antworten zu Windows 


Abfangen von Prozeduraufrufen 


F: Windows scheint die Funktionsargumente nicht auf Gül- 
tigkeit zu überprüfen. Gibt es einen Weg dies zu ändern. Gibt 
es eine transparente Möglichkeit um die globale Speicherver- 
waltung um das Auslagern von Daten zu erweitern? 


A: Die Antwort auf beide Fragen lautet »Ja«. Es gibt eine 
Technik zur Aliasierung von Prozedurnamen in Windows, 
mit der man sich transparent in Prozeduraufrufe einklinken 
kann. Sie kann für jede Art von Überwachung eingesetzt 
werden. 

Bauen Sie zunächst eine ausführbare Windows-Code- 
Bibliothek auf, die wie folgt aussieht: 


HANDLE MyGlobalAlloc( flags, size ) 
WORD flags; 
aaa size; 


/* Führen Sie hier alle gewünschten Kontrollen aus, z.B.: 


if ( !size ) 
return #; 


# 


return RealGlobalAlloc( flags, size ); 


HANDLE FAR PASCAL main( argce, argv ) 
WORD argc; 

LPSTR argv; 

{ 


return 1; 


Schreiben Sie dann folgende Definitionsdatei für die 
obige Bibliothek: 


FOO.DEF: 


LIBRARY FOO 

IDESCRIPTION "Procedure call interception library.” 

IDATA SINGLE MOVEABLE 

CODE MOVEABLE DISCARDABLE 

EXPORTS 
GlobalAlloc=MyGlobalAlloc 

IMPORTS 
RealGlobalAlloc=KERNEL. 15 


Die laufende Nummer der Kernel-Routinen (oder jeder 
anderen Routine) kann festgestellt werden, indem 
LIB.EXE auf die Bibliotheken SLIBW oder MLIBW ange- 
wendet wird. 

Sie bauen dann eine dynamische Link-Library auf, 
indem Sie IMPLIB wie folgt über F0O. DEF laufen lassen: 


'IMPLIB FO0.DEF FOO.LIB 





Bauen Sie die ausführbare Bibliothek mit folgendem 
Befehl auf: 


link4 foo, ,‚mlibw mlibe,foo.def; 
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Sie können dann eine dynamische Verbindung zu 
FOO.EXE aufbauen, indem Sie wie folgt mit F00.LIB 
linken: 


link4 bar,,,foo mlibw mlibc,bar.def; 





Alle Aufrufe von GlobalAlloc werden dann zunächst 
nach MyGlobalAlloc umgeleitet, weil der Name gleich- 
gesetzt wurde. 

Diese Technik ist sehr leistungsfähig und kann für jede 
Art von Überwachungsfunktion verwendet werden. Im Fall 
von GlobalAlloc ist die Überwachung transparent in dem 
Sinn, daß Sie die Anwendung nicht neu kompilieren müs- 
sen, um die Überprüfung zu entfernen. Linken Sie einfach 
mit MLIBW.LIB statt mit FOO.LIB, 


Pufferüberlauf bei WriteComm 


F: Wenn ich LPT1 öffne habe ich Probleme mit der Routine 
WriteComm. Wenn die Übertragungsqueue beim Aufruf von 
WriteComm Daten enthält, gehen die Daten in der Queue 
verloren. Wie kann ich dieses Problem vermeiden? 


A: Nach dem Öffnen eines Kommunikationsgeräts und der 
passenden Einstellung schreibt man Daten mit Transmit- 
CommChar zu dieser Einheit. Die Gefahr, daß Sie Daten 
verlieren, besteht, wenn sie die Übertragungsqueue nicht 
darauf überprüfen, ob diese genug Platz für die Übertra- 
gung hat. Der folgende Programmausschnitt ist ein Beispiel 
dafür, wie der Code, der dafür sorgt, daß dies nicht passiert, 
aussehen kann (abhängig davon, wie zeitkritisch Ihr Pro- 
gramm ist). 

Überprüfen Sie immer erst die Ausgabequeue, um 
sicherzustellen, daß genügend Platz vorhanden ist, bevor Sie 
WriteComm verwenden. Die Ausgabequeue, die Sie mit 
OpenComm deklarieren, sollte mindestens so groß sein, wıe 
der größte Ausgabestring. 





InLPTiCid = OpenGomn( {LPSTR) "LPT1”, nInd, ndutQ}; 


. /* Verwenden Sie SetConmState wenn die Standardein- */ 
. /* stellungen geändert werden sollen #/ 


/* Rufen Sie GetComnError auf, um sicherzustellen, dap kein 
* Druckerfehler aufgetreten ist und wenn doch, um ihn fest- 
zustellen. Wenn es ein Problem gegeben hat, korrigieren 

sie es. Der Aufruf von GetComnErrer übergibt auch die 
Anzahl Zeichen in der Queue und ermöglicht so, sicherzu- 
stellen, daß genug Platz im Puffer ist für einen Aufruf 
von WriteComs ohne Fehler. 


Die do-Schleife wartet, bis alle Druckerfehler korrigiert 
sind (oder beendet wenn nötig); dann wird sichergestellt, 
' daß genügend Platz in der Queue vorhanden ist, um die 
Te e Anzahl Zeichen zu übertragen. 
% 





Fragen & Antworten 





do 
{ 
while((nComErr=GetComnError (nLPT1Cid,IpLPTICOMSTAT)) t= NULL ) 


{ 
if (nQuit = LPTiError (nConErr)) 
break; 


} 
if (nQuit) 


break; 
Re (inÖutQ - nCharToSend & 1pLPTICOMSTAT->cbüOutQue) 
WriteComn( nLPTiCid, nCharToSendßbuf, nCharToSend); 


Die Anzahl der Funktionstasten feststellen 


F: Wie kann ich die von einem OEM unterstützten Tasten 
feststellen, z.B. die Funktionstasten [Fit] bis und auch 
andere Tasten, die von verschiedenen OEMs unterstützt wer- 
den. 


A: Die folgende Beispielanwendung zeigt, wie diese Infor- 
mation und auch die Anzahl der Mausknöpfe festgestellt 
werden kann; 


INFO.MAK: 








info.obj: info.c info.nak 
cl -d -c -AS -Gsw -Od -Zped info.c 


linfo.exe: info.obj info.def 


link4 info, /align:16, /map/li, slibw, info.def 
mapsym info 


INFO.DEF: 





NAME Info 
DESCRIPTION 'Get # of F keys and 7 of mouse buttons." 
| STUB 'WINSTUB.EXE' 


CODE MOVEABLE 
DATA MOVEABLE MULTIPLE 


HEAPSIZE 4896 
STACKSIZE 48996 


IMPORTS 
keyboardInquire = 
Mouselnquire 


Keyboard. 
Mouse. 





INFO.C: 


Jinclude "windows.h"” 


extern WORD FAR PASCAL KeyboardInquire ( LPSTR ); 
extern WORD FAR PASCAL Mouselnquire ( FARPROC }; 


typedef struct { 
char Begin First_range; 
char End First_range; 
char Benin. Second range; 
char End Second_range; 
WORD kbStateSize; /* bytes of state info from ToAscii. *# 
WORD kbNumFuncKeys;/* No of function keys on the keyboard. #/ 
WORD kbHasBreak; /* true = keyboard supplies make and break*/ 
0 kbRate; /* Maximum rate of keyboard input events. */ 

‚BINFO; 


KBINFO keybdinfo; 


typedef struct { 
char Exists; 
char Relative; 
short NunmButtons; 
short Rate; 
short XThresh; 
short YThresh; 
short XRes; 
short YRes; 


|} MOUSEINFO; 


|MOUSEINFO mouselInfo; 


int PASCAL WinMain{ hInstance, hPrevInstance, 
lpszCommandLine, cmdShow) 

HANDLE hinstance; 

HANDLE hPrevInstance; 

LPSTR 1lpszConnandLine; 

int cmdShow; 


register WORD i,k; 
char buff[45]; 


/* Get keyboard driver information. */ 
if ((i=KeyboardInquire( (LPSTR)&keybdInfo)) 
t= sizeof( KBINFO )) 


MessageBox (NULL, (LPSTR)"Keyboard info”, 
{LPSTR)"error", MB OK); 
return (1); 


sprintf(buff, "7 of Function Keys: Ad", 
keybdinfo.kbNumFfunckeys ); 
MessageBox (NULL, ({LPSTR)buff, (LPSTR)"Keyboard”, MB_OK); 


/* Get Mouse driver information. */ 
if ((i=Mouselnquirei( (FARPROC)&mouselnfo)) 
t= sizeof( MOUSEINFO ) ) { 
MessageBox (NULL, (LPSTR)"Mouse info”, 
(LPSTR)”error”, MB _OK); 
return (1); 


sprintf(buff,"7 of mouse buttons: %d”" mouselnfo.NumButtons ); 
MessageBox ( NULL, (LPSTR)buff, (LPSTR)"Mouse", MB OK); 
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Ein interaktives Debugging-System für Windows 


Microsoft Windows und CodeView sind zwei 
Produkte, die wegen ihrer stark interaktiven Be- 
nutzeroberfläche sichtbare Auswirkungen auf 
die PC-Welt hatten. Das Benutzerinterface von 
CodeView basiert auf zeichenorientierten Fen- 
stern, und bietet einen Bedienungskomfort, der 
bisher bei einem Debugger für Microcomputer 
nicht erhältlich war. Das Windows-Benutzer- 
interface ist ein vorgeschlagener Bedienungsstil 
und ein Paket von mächtigen Hilfsmitteln, die 
für die seine Implementierung benötigt werden. 


Dieser Artikel beschreibt CodeView für Windows (CVW), 
ein Produkt, das vielen DOS-Benutzern bekannt ist, das bis 
jetzt aber nicht mit Windows lief. Zuerst wollen wir sehen, 
warum ein interaktiver Debugger für den Programmierer 
hilfreich ıst. Nach einer genauen Beschreibung der Hard- 
warevoraussetzungen für CVW werden wir uns eine Beta- 
Version von CVW ansehen. Zu guter Letzt zeigt eine Bei- 
spielsitzung, wie die an das Hauptfenster einer Applikation 
gelangenden Nachrichten überwacht werden können. 

CodeView bietet viele der von Windows-Applikationen 
bekannten Neuerungen (Bild I), wie Drop-Down Menüs, 
Dialogboxen, Fenster und die Unterstützung der Maus. Es 
ist paradox, daß Windows-Programmierer dieses Hilfsmittel 
so lange nicht benutzen konnten. 

Es gibt aber eine einfache Erklärung hierfür. Die beiden 
Produkte wurden unabhängig voneinander von zwei ver- 
schiedenen Entwicklungsgruppen bei Microsoft entwickelt. 
CodeView wurde ursprünglich nicht für die Verwendung 
unter Windows entwickelt. Er diente der Entwicklung von 
DOS-Programmen. 

Obwohl das Interface dem von Windows gleicht, ist 
CVW keine Windows-Applikation im gewöhnlichen Sinne. 
Statt dessen ist es eine Spezialversion des Original Code- 
View, dem beigebracht wurde, wie die Speicherverwaltung 
von Windows arbeitet. Was Ihnen zuerst auffallen wird: 
CVW teilt sich den Bildschirm nicht mit Windows. CVW 
sendet seine Ausgaben an seinen eigenen Bildschirm- 
monitor, in der gleichen Weise wie Symdeb, ein anderer 
interaktiver Debugger. 


Interaktive Debugger 


In den Windows-Programmierklassen, die wir unterrichten, 
sind wir immer wieder erstaunt über die Anzahl der Leute, 
die noch nie einen interaktiven Debugger benutzt haben. Es 
gibt sicher Alternativen zu einem interaktiven Debugger, so 
wıe das Einfügen von Aufrufen von MessageBox zur 
Anzeige der Daten und der Aufruf von fprintf, um 
Traceinformationen an den Kommunikationsport auszu- 
geben. Diese Methoden sind aber kümmerlich, wenn man 
Sie mit den Möglichkeiten und der Flexibilität eines inter- 
aktiven Debuggers vergleicht, wobei Sie die volle Kontrolle 
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File Vieu Search Bun Watch Options Language Calls Help 
= z =| hello.c 
/# Hello.c 

Hello Application 

Windous Toolkit Version 2.03 

Copyright (c) Nicrosoft 1965,1986 ,1987,1988 


F@=Trace F5=G0 





Ü ax = oooo 
© BR = 0000 
CK = 0900 
© DE = 0000| 
Bsp = 0100 
BP = 0000 
= SI = 0000 
@ DI = 0000 
u DS = 514D 
2 88 = Sid 
E58 = 5161 
c5 = 5150 
im: . 
KU UP 

EL PL 

NZ HA 
PO NC 





wı 
1 
 # 







#include "windows .h" 
#include "hello.h" 








3: char szAppNane[10]: 
0: char szfbout[10]: 

1% char szliessagel15]1: 
2} int MessageLength: 







14: static HANDLE hinst: 
15; FARPROC Ipprochbout: 







7: long FAR PASCAL HelloWndProctHWND, unsigned, WORD, LONG): 











icrosoft (R) CodeVieuw {R) Version 2,2 = 
(C) Copyright Nicrosoft Gorp. 1986-1988. All rights reserved. E 


Bild1 


über den Computer haben, während Ihr Programm läuft. 
Ohne interaktiven Debugger müssen Sie Ihr Programm 
stoppen, umprogrammieren und wieder kompilieren, bevor 
Sie einen neuen Versuch wagen können. Ein interaktiver 
Debugger bietet Ihnen die Freiheit, zu entscheiden, wie Sie 
Ihr Programm erforschen wollen. Er erlaubt augenblick- 
liche Eingriffe in ein laufendes Programm auf einer Ebene, 
die sonst nicht möglich ist. 

Das anfängliche Arbeiten mit einem interaktiven 
Debugger ist aber nicht ganz einfach. Der Aufbau der 
Debuggerumgebung erfordert Zeit, und Sie müssen ein 
wenig mit dem Debugger vertraut sein, sonst ıst er nicht 
wirklich hilfreich. Durch die strengen Entwicklungsvor- 
gaben, die Programmierer haben, wird häufig keine Test- 
umgebung geschaffen. Es wäre aber dennoch die Zeit wert. 
Leute, die mit einem interaktiven Debugger arbeiten, haben 
ziemlich bald große Vorteile. 


Entwicklungsprobleme 


Sogar mit einem interakiven Debugger bietet das Debuggen 
einer Windows-Applikation einige Herausforderungen. Es 
wäre schon schlecht genug, wenn das dynamische Laden, 
Verschieben und Auslagern von Speicherobjekten die ein- 
zige Quelle der Probleme wäre. Doch die Struktur von 
Windows-Programmen, das Fehlen eines Hardware-Spei- 
cherschutzes, und die Tatsache, daß man sich mit so vielen 
Sachen wie den Routinen des Software Development Kits 
(SDK), der Intel-Architektur und der Programmierung in C 
gut auskennen muß, führen zu den Schwierigkeiten, die 
beim Programmieren und Testen einer Windows-Applika- 
tion auftreten. 

Für einige dieser Probleme ist die einzige Lösung Zeit 
und Geduld. Das Programmieren unter Windows verlangt 
von Ihnen alles über das Programmieren zu wissen, und 
trotzdem scheint es so, als wäre alles was Sie wissen falsch. 
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Windows 





Das Nutzen der Vorteile der Programmierung unter Win- 
dows/Presentations Manager erfordert von Ihnen das 
Erlernen neuer Denkweisen. Sechs Monate intensive Win- 
dows-Programmierung, unter der Voraussetzung, daß Er- 
fahrungen in C vorhanden sind, ist ein guter Anhaltspunkt. 

Während Sie diese Erfahrungen machen, sind einige 
Fehlerprüfungen jedoch kostenlos, sowohl vom Compiler, 
als auch von Windows selbst. Dies erfordert nur das Setzen 
der richtigen Schalter. Hier sind einige Vorschläge, um die 
Probleme zu überwinden, die sich beim Programmieren 
unter Windows ergeben. 

Verwenden Sie immer die höchste Warnungsstufe beim 
Übersetzen (W2 oder W3) und streben Sie nach einer feh- 
lerfreien Übersetzung. 

Deklarieren Sie jede Funktion die Sie schreiben. Sehen 
Sie hierzu auch die Beispiele in WINDOWS.H, wo Deklara- 
tionen wie 


BOOL FAR PASCAL TextOut(HDC, short, short, LPSTR, short); 





vorhanden sind. Diese Deklaration gibt dem Compiler 
wertvolle Informationen, wie den Rückgabewert (im Bei- 
spiel BOOL), die Aufrufkonvention (FAR und PASCAL), die 
Anzahl der Parameter (5) und den Typ jedes Parameters. 

Wenn Sie Ihre Funktionen deklarieren, dann können Sie 
schnell und leicht einige Programmierfehler in C vermei- 
den. In der Entwicklungsphase werden beispielsweise oft- 
mals Parameter zu Funktionen hinzugefügt. Wenn Sie es 
aber versäumen, jeden Funktionsaufruf zu ändern, enthält 
Ihr Programm einen Fehler. 

Dieser Fehler fällt auf Sie zurück, indem Ihr Programm 
sofort Fehler macht. In diesem Fall werden Sie vermutlich 
suchen, bis Sie den Fehler finden. Oder aber der Fehler tritt 
nicht sofort auf und verursacht dann zufällige und unvorher- 
sagbare Probleme. Da diese Art von Fehler vermieden wer- 
den kann, erspart Ihnen das Deklarieren Zeit und sollte 
immer in Verbindung mit den Compilerschaltern W2 oder 
W3 benutzt werden. 

Vermeiden Sie den Einsatz von Casts. Es ist in vielen 
Situationen überflüssig, und kann Fehler verbergen. Lassen 
Sie sich vom Compiler die Typunterschiede anzeigen, und 
verwenden Sie dann nur an diesen Stellen Casts. 
Der folgende Einsatz eines Casts ist überflüssig: 













Dies war aber in den früheren Versionen von Windows 
notwendig, da der Compiler zu dieser Zeit noch keine Pro- 
totyp-Deklarationen verarbeitete. Jede Version des Micro- 
soft C Compilers seit der Version 4.0 unterstützt Prototyp- 
Funktionsdeklarationen, und benötigt deshalb in vielen 
Fällen keine Casts. Die Deklaration gestattet es dem Com- 
piler, einen Near-Zeiger in einen Far-Zeiger zu wandeln. 

Vergewissern Sie sich, daß Sie jede Fenster-Prozedur, 


78 Microsoft System Journal September/Oktober 1988 





Dialogbox-Prozedur, Unterklassen-Prozedur in ein Pro- 
gramm einbeziehen (include), die in der EXPORTS-Liste 
Ihrer Moduldefinitionsdatei (DEF) enthalten ist. Dies ist ein 
häufiger Fehler, der viel Zeit kostet. Das Fehlen von Prüf- 
möglichkeiten vom Compiler und Linker in dieser Bezie- 
hung bewirkt, daß dieser Fehler schwer zu finden ist. 

Installieren und benutzen Sie eine Debugversion von 
Windows, nicht zu verwechseln mit einem zu Windows 
kompatiblen Debugger, wie CodeView. Sie erreichen dies, 
indem Sie spezielle Versionen von KERNEL.EXE, 
USER.EXE und GDI.EXE (aus dem SDK) verwenden. 

Die Debugversion führt Fehlerprüfungen durch, die in 
der normalen Version von Windows nicht verfügbar sind. 
Sıe handhabt Probleme, wıe ungültige Handles und wilde 
Zeiger und zeigt Ihnen dieses über ein Debugterminal an, 
das Sie zum Erhalten der fatalen Fehlermeldungen, auch 
RIP-Codes (Rest In Peace) genannt, bereithalten müssen. 
Vergewissern Sie sich auch, daß die Dateien KERNEL.SYS, 
USER.SYM und GDI.SYM vorhanden sind, die benötigt wer- 
den, um die Stack-Trace-Informationen anzuzeigen, wenn 
der RIP-Code erzeugt wird. 

Wenn Sie die Debugversion installieren, vergewissern 
Sie sich auch, daß die folgenden Schalter ın der Dateı 
WIN.INI gesetzt sind: 





| [kernel] 


EnableHeapfhecking=] 
EnableFreeChecking=1 





Dies bewirkt das Füllen aller freien Bytes mit dem Wert 
CCH. Das schützt Sıe auf zweifache Art. Erstens, wenn ein 
wilder Zeiger in Ihrem Programm in einen freien Block 
schreibt, wird eine fatale Beendigungsmeldung an Ihr 
Debugterminal gesendet. Zweitens sind Sie geschützt, wenn 
Ihr Programm einen freien Block anspringt. Der Wert CCH 
entspricht dem Maschinenbefehl INT 3, was den Aufruf 
des Debuggers zur Folge hat. Ein wilder Sprung aktiviert 
den Debugger und ermöglicht Ihnen so, den Stack anzu- 
sehen, und den Programmteil ausfindig zu machen, der zum 
Absturz führte. Wegen dieser Vorteile wird der Gebrauch 
dieser Schalter sehr empfohlen. 

Wenn Sie Expanded Memory (EMS) oder Windows/ 
386, das eingebaute EMS Unterstützung bietet, verwenden, 
vergewissern Sie sich, daß die folgenden Schalter in der 
Datei WIN. INI gesetzt sind: 





[kernel] 
' EnableEMSDebug=1 





Dieser Schalter bewirkt, daß dem Debugger mitgeteilt 
wird, wenn EMS-Speicherseiten gewechselt werden. Sie 
können so auch Breakpunkte in den auslagerbaren Code- 
segmenten der dynamischen Linkbibliotheken setzen, wo 
sich viele SDK-Routinen befinden. 


Windows 





Fi 

7 Standard command line definitions 
ri 

ep=cl -d -c -AS -Gsw -Od -Zpie 

ri 

# Standard inference rules 


# 
7.c.ob]:$(cp) # 
Gi 


# 
# The C File List 
F 


hello.obj: hello.c hello.h 


hello.res: hello.rc hello.ico hello.h 
rc -r hello.rc 


hello.exe: hello.obj] hello.res hello.def 
link4 hello/CO,/align:16, ‚slibw/NOE,hello.def 
rc hello.res 





Bild 2 


Hardwarevoraussetzungen 


CVW stellt einige Anforderungen an die Hardware. So ist 
das Vorhandensein eines zweiten Monitors Voraussetzung. 
Wir werden uns die verfügbaren Möglichkeiten ansehen, 
und die Notwendigkeit von EMS-4.0-Speicher diskutieren. 
Wenn Sie SymDeb verwendet haben, ist die Installation des 
zweiten Monitors dieselbe, und Sie sind bereit für CVW. 

Sie haben zwei Möglichkeiten. Einen monochromen 
Bildschirmadapter (MDA) mit einem Monochrommonitor 
oder ein asynchrones Terminal mit einem Nullmodem- 
Adapter. Die erste Lösung ıst vorzuziehen, da Sie CVW 
dann im Ganzbildschirmmodus benutzen können. Ein asyn- 
chrones Terminal ist hilfreich, da Sie Vorteile beim Zugriff 
auf die lokalen Variablen haben, die Code View unterstützt. 
Sie müssen aber im Zeilenmodus ohne Ganzseitenanzeige 
arbeiten. 

Wenn Sie im Ganzseitenmodus arbeiten, können Sie mit 
CodeView die Maus benutzen, um Menüpunkte anzuwäh- 
len, und seine Aktionen kontrollieren (wenn CodeView die 
Kontrolle hat). Auf diese Art arbeitet Codeview wunderbar, 
indem es die Maus mit Windows teilt. Sie müssen aber den 
DOS-Maustreiber laden, den CVW dann für seine Maus- 
unterstützung benötigt. Sogar wenn Sie keine Maus benut- 
zen (zum Beispiel im Zeilenmodus), müssen Sie dennoch 
einen Treiber installieren. Ansonsten funktioniert die Maus 
ın Windows nicht mehr, obwohl Sie weiterhin Windows mit 
der Tastatur bedienen könnten. Wir hoffen, daß dieses Pro- 
blem vor der Auslieferung von CVW behoben ist. 


C> cvw /2 /L hello.exe \windows\win.com hello.exe 
1C> cvw /C=comi /T /L hello.exe \windows\win.com hello.exe 





EMS-4.0-Speicher 


CVW verlangt EMS-4.0-Speicher im System. CVW braucht 
bis zu 138 Kilobyte Hauptspeicher, und kann darüber hin- 
aus EMS-Speicher für Code, Daten und Symboltabellen 
verwenden. Die verfügbaren Optionen hängen von der ver- 
wendeten Version von Windows ab. Mit Windows 2.x müs- 
sen Sie ein EMS-Board oder einen EMS-Treiber der Ver- 
sion 4.0 oder später verwenden. Wir unternahmen Versuche 
mit einem Intel Above Board und mit einem AST RAM- 
page Board. Beide arbeiteten fehlerfrei, aber Sie müssen 
auf die richtige Version des Treibers achten. 

Windows /386 enthält EMS-4.0-Unterstützung, die auch 
von CVW verwendet werden kann. Hierbei müssen Sie aber 
zwei Dinge beachten. Erstens müssen Sie mindestens 640 
Kilobyte Hauptspeicher und 512 Kilobyte Extended Spei- 
cher haben, damit der EMS-Speicher überhaupt unter Win- 
dows/386 verfügbar ist. Zweitens müssen Sie einen Trick 
anwenden, damit die Unterstützung von EMS zuerst gela- 
den wird. Sie starten dann CVW, bevor Sie Windows star- 
ten. Dieser Vorgang ist detailliert in der Dokumentation 
beschrieben. 


CodeView und Windows 


Nun da CodeView verfügbar ist, um Windows-Applikatio- 
nen zu debuggen, werden sich die Windows-Programmierer 
fragen, ob seine Fähigkeiten ausreichen, um die extrem 
komplexen Windows-Applikationen zu untersuchen. Die 
Antwort ist ja. Lassen Sie uns CodeViews Stärken und 
Schwächen in der Windows-Umgebung untersuchen, wobei 
zu bedenken ist, daß wir eine Beta-Version verwenden. 


Windows-Programme 


Jeder Windows-Programmierer lernt sehr schnell, daß eine 
Windows-Applikation sich nicht selbst kontrolliert. Sie lebt 
vielmehr von den Nachrichten, die der Benutzer, Windows 
oder andere Programme schicken. Windows-Programme 
haben nicht ımmer Kontrolle über den Prozessor, statt- 
dessen sind Sie meistens unterbrochen, und warten auf 
ankommende Nachrichten. 

Wird eine Nachricht an ein Windows-Programm über- 
geben, bekommt dieses den Prozessor zugeteilt, und muß 
auf diese Nachricht antworten. Die Nachricht wird oftmals 
an die GetMessage-Bearbeitungsschleife übergeben. Von 
hier geht die Kontrolle an die entsprechende Fensterfunk- 
tion. Die Entscheidung basiert auf einem Teil der Nach- 
richt, der Fenster-Handle. 

Wenn eine Wındows-Funktion eine Nachricht erhält, 
untersucht Sie den Nachrichtentyp und springt in der Regel 
in eine Nachrichtenfunktion genannte Prozedur. Jede Nach- 
richtenfunktion ist in der Beziehung unabhängig von der 
anderen, da Sie nicht weiß, ob andere Nachrichten schon 
eingegangen sind oder folgen werden. 
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Windows 










File View Search Run Watch Options Language Calls Help 
PER BE hello. re 
/# Hello.c 

Hello Application 

Windows Toolkit Version 2.03 

Copyright (c) Hicrosoft 1985 ,1986 ,1987,1988 " 










#include "windous.h" 
#include "hella.h" 









char szAppNane[10]: 

19: char szfibout[10]: 
1: char szlliessage [15]: 

12: int HessageLength: 








static HANDLE hinst: 
FARPROC Ipprochbout: 


long FAR PASCAL HelloWndProctHWND, unsigned, WORD, LONG): 













icrosoft ({R) CodeView (BR) Version 2.2 


{C) Copyright Nicrosoft Corp. 1986-1988. All rights reserved. 





Bild 4 


Sie kann nur den augenblicklichen Zustand der 
Applikation testen, zum Beispiel die aktive Zelle einer 
Tabellenkalkulation, und entsprechend reagieren. 

Das klassische Beispiel einer Windows-Nachricht, auf 
dıe Applikationen reagieren müssen ist WM_PAINT. Als 
Antwort darauf muß eine Fenster-Funktion in jedem Fall 
seinen Client-Bereich neu darstellen. In dieser Beziehung 
reagiert ein Windows-Programm nur. Es ist der Benutzer, 
nicht das Programm, der den Programmablauf bestimmt. 

Ein Windows-Programm kann auch als Automat 
betrachtet werden, dessen Zustand in externen Variablen 
abgespeichert ist. Windows-Programme unterscheiden sich 
auch von normalen Programmen dadurch, daß Sie objekt- 
orientiert sind. Fensterklassen, Fenster, Anzeigekontexte, 
GDI-Objekte und geladene Ressourcen sind alle Objekte. 
Sie werden durch eine Handle identifiziert, und Sie brau- 
chen sich nicht um die zugehörige Datenstruktur kümmern. 
Ein gegebenes Objekt, wie etwa ein Fenster, kann in einer 
bestimmten Art verändert werden (jedes Fenster kann ver- 
schoben, in der Größe verändert, neu gezeichnet oder mit 
einer Nachricht versehen werden). 

Windows ist auch eine bibliothekenorientierte Umge- 
bung (speziell dynamische Linkbibliotheken). Alle Ent- 
wicklungskit-Routinen sind in dynamischen Linkbibliothe- 
ken enthalten. Sie können dynamische Linkbibliotheken 
verwenden, um Code, Ressourcen, Daten und die Kontrolle 
über die Allokierung beschränkter Ressourcen, wie System- 
speicher, oder eines Netzwerkadapters gemeinsam zu ver- 
wenden. 


Das Debuggen mit CodeView 


Programme bestehen aus zwei Teilen, Code und Daten. 
Einer der Hauptgründe für die Verwendung eines interakti- 
ven Debuggers ist, Ihnen die Möglichkeit zu geben, die 
Wege durch den Code zu verfolgen. Während dieser Reise 
können Sie die Daten, die Ihr Code bearbeitet, sehen und 
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D:XHELLO>cvu #2 /L hella.exe c:\windous\win.con hello.exe 





Bild 5 


sogar manipulieren. CodeView bietet drei Möglichkeiten 
die Ausführung zu verfolgen. Die zeilenweise Ausführung, 
Ausführung in reduzierter Geschwindigkeit, und die Aus- 
führung in voller Geschwindigkeit, wobei aber die Ausfüh- 
rung an einer bestimmten Stelle im Code oder abhängig von 
vorher festgelegten Datenbedingungen angehalten werden 
kann. Die zeilenweise Ausführung ist entweder auf Quell- 
code oder auf Objektebene möglich. Die Ausführung in 
reduzierter Geschwindigkeit bedeutet ungefähr 4 Anwei- 
sungen je Sekunde, wobei ständig die Anzeige von Code 
und Daten synchron aktualisiert wırd. 

Ein in reduzierter Geschwindigkeit ablaufendes Pro- 
gramm kann ständig angehalten werden, um andere Aktio- 
nen mit dem Debugger durchzuführen. Von jetzt an werden 
wir die Ausführung in reduzierter Geschwindigkeit als 
Ausführen des Programms, das Ausführen in voller 
Geschwindigkeit dagegen als Laufenlassen bezeichnen. 

Die dritte Technik, das Laufenlassen eines Programms 
mit voller Geschwindigkeit und das Anhalten an vorher 
bestimmten Punkten verlangt das Setzen von Break-, 
Watch- und Tracepunkten. Das Setzen eines Breakpunktes 
bedeutet die Angabe einer Stelle des Codes, an der das 
Programm halten soll. Dies wird durch Anklicken der ent- 
sprechenden Zeile in der Codeanzeige erreicht oder durch 
dıe Verwendung des Breakpoint-Kommandos (bp). 

Die Zeile, an der der Breakpunkt steht, wird hervorge- 
hoben angezeigt. Sie können den Breakpunkt löschen, 
indem Sie ihn noch einmal anklicken. Anschließend ist dıe 
Darstellung dieser Zeile wieder normal. Es können gleich- 
zeitig maximal 19 Breakpunkte gesetzt werden. Eine Unge- 
reimtheit gibt es bei dieser Sache. CVW zeigt Zeilen mit 
Breakpunkten intensiv an. Die aktuelle Zeile beim Tracen 
ist aber auch intensiv dargestellt. Diese Darstellung macht 
es schwierig, herauszufinden, ob in der aktuellen Zeile ein 
Breakpunkt ist, oder nicht. Um dies zu erkennen, müssen 
Sie an eine andere Stelle tracen. 





Windows 


Watch Options Language Calls Help 
1, —— 
138: it 
39: ‘# Procedures uhich make up the window class. * 
440: long FAR PASCAL HelloWndProc( hUnd, message, wParan, lParam ) 
141: HUND hund; 
142: unsigned message; 
143: WORD uParan: 
144: LONG 1Paranı 
{ 





File View Search Run FA=Trace FS=6c 













PAINTSTRUCT ps; 
switch (message) 


{ 
case WN_SYSCOMNAND: 
switch (uParan) 










{ 

case IDSABOUT: 

154: DialogBox( hinst, NAKEINTRESOURCE (ABOUTBOR), hund, Ipprocäb 

55: break: j N 
icrosoft {R) CodeView (RA) Version 2.2 

tC) Copyright Nicrosoft Corp, 1986-1988. 

?bp .148 


All rights reserved. 


Bild 6 


So wie Breakpunkte Haltepunkte sind, die im Code 
gesetzt werden, sind Watch- und Tracepunkte Haltepunkte, 
die auf Datenwerten basieren. Ein Watchpunkt ist ein 
bedingtes Statement, das eine oder mehrere Variable ent- 
hält, wie z.B. count==88. Die Programmausführung hält 
an der Stelle an, an der der Watchpunkt wahr wird. 

Ein Tracepunkt bezieht sich auch auf eine oder mehrere 
Variablen, aber er muß kein bedingtes Statement sein. Das 
Programm hält immer an, wenn sich der Wert des Trace- 
punktes verändert, unabhängig von seinem Wert. 

Ein schöner Effekt bei Break-, Watch- und Tracepunk- 
ten ıst, daß Sie erhalten bleiben, sogar nach dem Ende des 
Programms. So können Sie diese setzen und das Programm 
mehrere Male laufen lassen. Lokale Variablen sind bei 
Watch- und Tracepunkten nicht ganz so schön. Die lokalen 
Variablen sind nur innerhalb der Funktion gültig, in der sie 
definiert sind, und deshalb sind sie CodeView auch nur zu 
dieser Zeit bekannt. Wenn Sie also einen Watch- oder 
Tracepunkt auf eine lokale Variable setzen wollen, müssen 
Sıe zuerst einen Breakpunkt bei der Funktion setzen, und 
das Programm bis zu diesem ausführen. Jetzt können Sie 
den Watch- oder Tracepunkt auf die lokale Variable setzen, 
löschen, oder das Programm weiter ausführen. Eine Ein- 
schränkung von Codeview und jedem anderen interakiven 
Debugger ist, daß die Eingaben zwischen dem Programm 
und dem Debugger aufgeteilt werden müssen. Natürlich 
benötigt Ihr Programm Eingaben, die es entweder durch die 
Maus oder von der Tastatur erhält. Und ebenso benötigt 
der Debugger Eingaben. Im Falle von CodeView können 
sowohl Maus als auch Tastatur benutzt werden. Das Debug- 
gen der Maus- oder Tastatureingaben kann jedoch schreck- 
lich sein. Natürlich gibt es Auswege. 

Zum Beispiel kann das Setzen eines Breakpunktes zur 
Überwachung der Bearbeitung der Nachricht WM_MOUSE- 
MOVE sehr schwierig, wenn nicht sogar unmöglich sein. Eine 
andere Einschränkung bei jedem interaktiven Debugger ist 
das Testen von zeitkritischen Anwendungen. 





Bild 7 


Daher ist CVW bei der Verwendung mit Programmen, 
die die Nachricht WM_TIMER benötigen, eingeschränkt. 
Wenn Ihr Programm externe Echtzeitereignisse verfolgen 
muß, so ist dieser Teil der Applikation wahrscheinlich mit 
einem interaktiven Debugger nicht zu testen. 


Das Debuggen unter Windows 


Aufgrund der Tatsache, daß Windows-Programme auf 
Nachrichten reagieren, können sie als Automaten betrach- 
tet werden, und außerdem befinden Sie sich in einer objekt- 
orientierten und dynamischen Linkbibliotheken-Umgebung. 
Wie kann uns hier CVW bei der Fehlersuche helfen? CVW 
behandelt die reagierende Natur eines Windows-Pro- 
gramms sehr gut, vor allem wegen seiner ausgezeichneten 
Fähigkeiten, den Programmablauf zu verfolgen. Durch das 
Setzen von Break-, Watch- und Tracepunkten können Sie 
sehen, welche Arten von Nachrichten ankommen, und was 
das Programm mit diesen Nachrichten anfängt. Später wer- 
den wir dies tun, indem wır den Nachrichtenverkehr unter- 
suchen, der beim Erzeugen des Hauptfensters einer Appli- 
kation anfällt. 

CVW paßt auch gut zu der Automatennatur einer Win- 
dows-Applikation. Da der Zustand in Programmvariablen 
festgehalten wird, und der Benutzer sieht, wie sich diese 
Variablen beim Programmlauf verändern. Der Benutzer 
kann sogar anhalten, wenn die Variablen einen unerwarte- 
ten Wert annehmen. Er kann sich auch vom Zustand des 
Programmes überzeugen, wenn es läuft, und so Probleme in 
diesem Bereich erkennen. CVW hat nur begrenzten Wert 
bei der Behandlung der objektorientierten Natur eines 
Windows-Programms. Dies ist nicht so sehr eine Schwäche 
von CodeView, sondern rührt daher, daß Objekte außer- 
halb des Datensegments des Programms gehalten werden. 
Stifte, Pinsel, Zeichensätze, Bitmaps, global allokierter 
Speicher, und die Datenstruktur, die ein Fenster beschreibt, 
entziehen sich dem leichten Zugriff durch CodeView. 
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Windows 


/* Procedures which make up the window class. 

long FAR PASCAL HelloWndProct hund, message, uParan, 1Paran ) 
HWND hund: 

unsigned message; 

WORD uParan; 

LONG 1Paran; 

{ 


PAINTSTRUCT ps: 


syitch (nessage) 


case WH_SYSCOHNAND: 
switch (uParam) 


case IDSABOUT: ’ 
DialogBoxt hinst, MAKEINTRESOURCE(ABOUTBOR), hund, Ipprochbt 
break: 

default: 


Wenn Sie die Inhalte eines Speicherobjektes, eines Cur- 
sors, eines Sinnbilds oder einer Bitmap sehen wollen, bietet 
der Heapwalker die entsprechende Unterstützung. Wenn 
Sie etwas über ein GDI-Objekt erfahren wollen, können Sie 
die Routine GetObject aufrufen, um die Werte in eine 
Programmvarıable zu übertragen, die dann mit Codeview 
angesehen werden kann. Wenn Sie Informationen über ein 
anderes Objekt, wie etwa ein Fenster sehen wollen, so müs- 
sen Sie die zugehörige Toolkit-Routine, wie GetWin- 
dowWord benutzen, und die Informationen in eine Pro- 
grammvariable übertragen. CVW ist in einer objektorien- 
tierten Umgebung nützlich, da Sie Handles und Zeiger 
ansehen können, die innerhalb Ihres Programms gehalten 
werden. Durch das Setzen von Tracepunkten können Sie 
Veränderungen der Werte der Handles erkennen, und Sie 
sind in der Lage, Ereignisse wie das unbeabsichtigte Über- 
schreiben einer Handle oder eines Zeigers zu finden. Sie 
sehen auch, wenn eine NULL-Handle zurückgegeben wird, 
was einen Fehler bedeutet. 

CVW unterstützt Sie auch beim Arbeiten mit dynami- 
schen Linkbibliotheken. CVW gestattet Ihnen das Tracen 
auf Sourcecode-Ebene in Ihren dynamischen Linkbibliothe- 
ken, was Ihnen ein genaueres Bild über die Ausführung 
Ihrer Applikation vermittelt. 

Wenn Sie den Code in einer dynamischen Linkbiblio- 
thek von Windows, wie etwa KERNEL, USER, oder GDI 
sehen möchten, erlaubt Ihnen CVW auch dieses. Seine 
Nützlichkeit hängt aber davon ab, ob Sie die Assembler- 
sprache des 8086 verstehen, oder nicht. Da Sie den QOuell- 
code zu den dynamischen Linkbibliotheken nicht haben, 
können Sie nur auf Maschinencode-Ebene tracen. Wenn Sie 
einigermaßen mit dem 8086-Assembler vertraut sind, kann 
dieses helfen, zu erkennen, was eine bestimmte Routine 
unter gewissen Bedingungen macht. 
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140: long FAR PASCAL HelloWndProct hund, message, wParan, 1Paran ) 





Fö=Trace FS5=6o 






DJ) message,x 


141: HUND hund: 
142: unsigned message: 
143: WORD uParan; 
44: LONG 1Paran; 
{ 


145: 
146: PAINTSTRUCT ps; ' 
147: ; 
148: switch (message) . 
149: 
150: case WH_SYSCONMAND: 
151: switch (wParan) 

152: { 

153: case IDSABOUT: 

154: DialogBox{ hinst, MAKEINTRESOURCE(CABOUTBOX), hund, Ipprochb 


155: break; | 





Eine Beispielsitzung 


Wir sind jetzt bereit, uns eine Beispielsitzung mit CVW 
anzusehen. Unsere Absicht ist, Ihnen zu zeigen, wie das 
Setzen eines Breakpunktes auf die switch-Anweisung der 
Fenster-Prozedur es gestattet, die Nachrichten, die beim 
Erzeugen eines Fensters anfallen, zu beobachten. 


Der Beginn 


Das Programm, das wir untersuchen, ist das Beispielpro- 
gramm »Hello Windows« von der Beispieldiskette des SDK 
Version 2.03, das Sie vom Windows SDK kopieren sollten, 
um die Debugsitzung nachvollziehen zu können. 

Der erste Schritt ist die Änderung der Make-Datei des 
Programms, damit Sie die benötigten Compiler- und Lin- 
ker-Schalter enthält. Das bedeutet das Hinzufügen der 
Schalter /Zi und /Od zu den Compiler-Optionen und /CO 
zu den Linkeroptionen. Die komplette Make-Datei sehen 
Sie in Bild 2. 

Nachdem Sie HELLO.EXE neu erzeugt haben, starten 
Sie CVW durch einen der beiden im Bild 3 gezeigten Auf- 
rufe. Wenn Sie einen MDA-Adapter mit einem monochro- 
men Bildschirm benutzen, der Ihnen das Debuggen mit 
Ganzseitenanzeige erlaubt, dann sollten Sie den ersten Auf- 
ruf benutzen, Benutzen Sie aber ein asynchrones Terminal 
mit einem Nullmodem-Adapter als Debug-Terminal, was 
Ihnen nur den Zeilenmodus ermöglicht, so müssen Sie den 
zweiten Aufruf benutzen. 

Im Rest dieser Sitzung wird der Ganzseitenmodus 
benutzt. Beim Start von CVW sehen Sie die beiden Bild- 
schirmanzeigen in den Bildern 4 und 5. Im Bild 4 sehen Sie, 
daß Codeview gestartet ist. Im Bild 5 jedoch sehen Sie, daß 
Windows selbst noch nicht gestartet ist. 


Windows 


Bild 10 


Setzen der Breakpunkte 


Setzen Sie zuerst einen Breakpunkt am switch-Statement 
der Fenster-Prozedur, was bedeutet, daß Sie zuerst die 
Quellcodezeile suchen müssen und sie dann entweder mit 
der linken Maustaste anklicken, oder das BP-Kommando 
benutzen und die entsprechende Zeile angeben. Bild 6 zeigt 
den gesetzten Breakpunkt mit dem intensiv dargestellten 
BP-Kommando. 


GO 


Führen Sie dann das Programm aus. Bei der Eingabe des 
GO-Kommandos sehen Sie, wie zuerst Windows startet. 
Bild 7 zeigt die Bildschirmanzeige nachdem Windows ge- 
startet ist, und das System den Breakpunkt bei dem 
switch-Statement erreicht hat. Beachten Sie, daß der Win- 
dows-Bildschirm das vertraute Blau anzeigt, obgleich nichts 
darauf abgebildet ıst. Auf der Anzeige von CodeView sehen 
Sie, daß die Maus aktiv ist und Sie Kommandos eingeben 
können. 


Die Watch-Liste 


Jetzt werden wir die lokale Variable message zu der 
Watch-Liste hinzufügen. Da wir die Variable hexadezimal 
angezeigt bekommen wollen, hängen wir einen Typmodifi- 
zierer an das w?-Kommando an. Wir fügen message zu der 
Watch-Liste, indem wir beim CodeView-Bereitzeichen fol- 
gendes eingeben: 







> wW? message, X 





Bild 8 zeigt, daß das Watch-Fenster geöffnet wurde, und 
daß der augenblickliche Wert von message (®024H) ange- 


Hello Hindows! 





Bild 11 


zeigt wird. Ein kurzer Blick in die Datei WINDOWS.H zeigt 
daß dieser Wert die Nachricht WM_GETMINMAXINFO 
bedeutet. Obwohl unser Fenster eine Nachricht erhalten 
hat, wurde Sie bis jetzt noch nicht bearbeitet. Um die Nach- 
richt zu bearbeiten, geben wir erneut das Kommando g 
(GO) ein, und die Ausführung stoppt am nächsten Break- 
punkt. Die Bildschirmanzeige sieht jetzt wie in Bild 9 aus. 
Beachten Sie, daß die CVW-Anzeige den Wert 0881H für 
message anzeigt, und daß sich die Windows-Anzeige nicht 
verändert hat. 
Die nächsten Nachrichten sind: 


WM_SETVISIBLE 
'WM_ACTIVATEAPP 





Der Nichtclient-Bereich 


Die erste Nachricht, die etwas auf den Bildschirm bringt ist 
die Nachricht WM_NCACTIVATE. Der Teil NC der Nachricht 
steht für Not Client. Wie Bild 10 zeigt, erfolgt lediglich das 
Zeichnen des Fensterrandes zusammen mit der Systembox 
und den Boxen für Minimize und Maximize. 

Die nächste Nachricht, WM_GETTEXT, scheint die Titel- 
zeile anzuzeigen. Tatsächlich nehmen wir an, daß das vor- 
hergehende WM_NCACTIVATE eine WM_GETTEXT-Nachricht 
schickte, um diese Windows-Meldung zu erhalten, um die 
Titelzeileninformationen richtig anzeigen zu können. 

Eine weitere Gruppe von Nachrichten, die die Anzeige 
beeinflußen erscheint, sind folgende: 
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Windows 


Bild 12 


Löschen des Hintergrunds 


Bild 12 zeigt den Effekt der Nachricht WM_ERASEBKGND. 
Der Hintergrund des Fensters ist mit der voreingestellten 
Hintergrundfarbe des Hauptfensters, das weiß ist, gelöscht 
worden. Es erscheinen weitere Nachrichten: 





Sie sollten bedenken, daß diese beiden Nachrichten 
beim Erzeugen des Fensters ankommen, was wichtig ist, 
wenn Sie planen, auf diese Nachrichten antworten zu wol- 
len. Denken Sie über diese Nachrichten, als wenn Sie sagen 
würden, das Fenster ändert sich in der Größe von Nichts in 
Etwas und bewegt sich von Nirgendwo nach Irgendwo. 


Hello Windows! 


Wenn zu guter Letzt die WM_PAINT-Nachricht ankommt, 
erscheint das vertraute »Hello Windows«, wie in Bild 13. Es 
scheint, als seien schon zu viele Nachrichten bei der Erzeu- 
gung eines Fensters eingetroffen, aber es kommen noch 
zwei weitere, nämlich: 








'WM_NCHITTES 
WM SETCURSOR 






Die letzte ankommende Nachricht ist WM_MOUSEMOVE., 
Dies beschließt den Nachrichtenverkehr beim Erzeugen des 
Fensters. Zusammen sind 20 Nachrichten bei der Fenster- 
prozedur angekommen, bevor der Prozeß der Erzeugung 
des Fensters abgeschlossen ist. 

Jetzt wird beim Bewegen der Maus eine weitere 
WM_MOUSEMOVE-Naächricht an die Fensterprozedur der 
Applikation gesendet. Sie müssen den Breakpunkt löschen. 
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Bild 13 


Ansonsten werden Sie immer von der Mausbewegungs- 
nachricht unterbrochen. Sie tun dies, indem Sie entweder 
nochmals die Zeile mit der Maus anklicken, oder durch das 
Kommando BC 2. 

Vor dem Verlassen von CodeView müssen Sie Windows 
beenden. Dies deshalb, weil Windows das System, inklusive 
einiger Systemvektoren, ändert, und diese wieder hergestellt 
werden müssen, damit das System normal arbeiten kann. 
Danach können Sie CodeView mit dem OUIT-Kommando 
verlassen: 


Ein Durchbruch 


Wenn CodeView für Windows verfügbar sein wird, wird 
dies ein Durchbruch für Windows-Entwickler sein. Das 
Interface ist leicht zu handhaben. Seine Fähigkeiten, auf 
lokale Variablen zuzugreifen, Datenstrukturen anzuzeigen 
und komplexe C-Ausdrücke auszuwerten, geben ihm die 
Fähigkeiten einer neuen Generation von Debuggern. 

Sein Speicherbedarf (138 Kilobytes) und die Notwendig- 
keit für EMS-Speicher kann seine Nützlichkeit für einige 
Entwickler jedoch einschränken. Im Gegensatz dazu benö- 
tigt SymDeb 43 Kilobytes, bietet aber nicht das Ganzseiten- 
Benutzerinterface und den Zugriff auf lokale Variablen, die 
Teil von CodeView sind, was für gewisse Windows-Appli- 
kationen immer hilfreich ist. Ebenso bietet die von uns 
untersuchte Kopie von CodeView nicht alle Zugriffe zu den 
Internas von Windows, die SymDeb bietet, wie die Ausgabe 
des globalen Heaps, die Anzeige der freien Liste usw. Das 
ist aber ein kleiner Nachteil, verglichen mit den großen 
Vorteilen, die das Benutzerinterface von Code View bietet. 

Paul Yao/David Durant 


Makro-Assembler 





Verbesserte Makros und Sprachenschnittstellen 


Interrupt Routinen, sehr schnelle asynchrone 
Schnittstellenroutinen, direkte Bildschirmspei- 
cherzugriffe, direkte Diskroutinen, die Sprache 
C, was paßt hier nicht zusammen? 


Bis jetzt werden Sie möglicherweise die Sprache C vermu- 
tet haben. Ich hätte es bestimmt. Wann immer es nötig war, 
eine Routine zu programmieren, die Außergewöhnliches 
schnell und effizient tun sollte, kam mir die Verwendung 
einer Hochsprache wie C nie in den Sinn. Der gesamte 
Overhead des Pushens des BP-Registers, sogar wenn keine 
Stackreferenz notwendig ist, das Verändern von Volatil- 
Variablen von einer es gut meinenden Optimierungsroutine 
und die langen Übersetzungszeiten legten mir die Verwen- 
dung des Microsoft Makro-Assemblers (MASM) nahe. 

Dies bedeutete natürlich das umständliche Erzeugen der 
Prozedureinleitungs- und Prozedurschlußanweisungen für 
jede MASM-Routine. Ganz zu schweigen von der zusätz- 
lichen Arbeit, wenn mein Programm 64 Kilobyte über- 
schreitet, und ich auf das nächste Speichermodell umstellen 
muß. Ich nahm es auf mich. Ich glaubte immer, daß es zu 
viel Arbeit ist, ein Speichermodell-unabhängiges Programm 
mit MASM zu schreiben, bis ich begann, Makros zu ver- 
wenden. 

Makros sind möglicherweise die am wenigsten benutz- 
ten Hilfsmittel des Assemblerprogrammierers. Ein Makro 
ist die Abkürzung für den öfteren Gebrauch desselben 
Programmteils. PUSH_ALL und POP ALL sind sicher 
Dinge, die jeder Programmierer benötigt, weshalb also 
nicht eine Abkürzung einführen, die dann später zu den 
zugehörigen Anweisungen expandiert wird? Mit der Einfüh- 
rung von MASM 5.0 wurde das Programmieren von Makros 
durch einige gut geschriebene Makros erleichtert, die im 
Paket enthalten waren. Meine Produktivität verbesserte sich 
erheblich, meine Programme wurden leichter lesbar, ich 
brauchte nicht mehr Stunden, um auf ein anderes Spei- 
chermodell umzustellen, und ich hatte genügend Zeit, Aus- 
reden dafür zu suchen, daß ich meine Arbeit wenig doku- 
mentiere. 

Mit der Version 5.1 wurden viele Makros überflüssig, da 
ihr Funktionalität jetzt im Assembler selbst enthalten ist. 
MASM 5.1 enthält die Änderungen, die ich auch vorge- 
nommen hätte, wenn er von mir stammen würde. 

Daher ist eventuell einiges Neucodieren Ihrer Pro- 
gramme notwendig. Dieser Artikel untersucht die Ände- 
rungen, die notwendig sind, um die Vorteile und Neuerun- 
gen des MASM 5.1 auszunutzen. 


Die Beschränkung von C 


Der Overhead in einigen C-Routinen kann ein Problem 
sein, wenn Sie versuchen, guten, sauberen und schnellen 
Code zu schreiben. Denken Sie an die Funktion movmen, 
Stellen Sie sich überlappende Quell- und Zielbereiche vor. 


Sie können keine so schnellen und sauberen Funktionen 
schreiben, die zwei Zwecke erfüllen, als wenn sie nur eine 
Aufgabe erledigen. 

Sogar der direkte Aufruf von DOS-Interrupts ist nicht 
effizient. Obwohl Sıe genau wissen, daß nur ein oder zwei 
Register vor dem Aufruf vorbesetzt sein müssen, weıß dies 
die Int86-Funktion nicht. Sie rettet alle Register, lädt 
diese von der REGS-Struktur, ruft den Interrupt auf, spei- 
chert alle Register in die REGS-Struktur (oder eine andere), 
und poppt wieder alle Register. Denken Sie an diesen Auf- 
wand, wenn Sie nur einfach das AH-Register setzen müs- 
sen, und sogar der Rückgabewert uninteressant ist. Neben 
dem künstlichen Vergrößern des Programms benötigen 
diese überflüssigen Befehle Prozessorzeit. Das ergibt wie- 
der den Overhead, den Sie eigentlich durch den direkten 
DOS-Aufruf vermeiden wollten. 

Einige spezielle Operationen verlangen auch nach der 
Effizienz von MASM-Routinen. Speicherübertragungen 
zwischen verschiedenen Segmenten, das Umleiten eines 
Interrupts (wie des Timers, der Tastatur oder der seriellen 
Schnittstelle) oder etwas ausgefallenes, wie etwa ein Over- 
layloader. 


Die Schnittstelle von MASM und C 


Es gibt einige Probleme, wenn Sie aus einer MASM-Rou- 
tine das Beste herausholen wollen. Verwenden Sie eine C- 
Funktion, die von einer Interrupt-Routine in Assembler 
aufgerufen wird, verursacht dies einige Verwirrung. Sie 
müssen eigenen Stack bereitstellen, irgendwoher das Daten- 
segmentregister wiederherstellen und sich bewußt sein, daß 
der Aufruf auch nur einer C-Funktion jedes Register 
ändern kann. 

Das Lesen der Variablen vom Stack, wenn eine C-Funk- 
tion eine Assemblerroutine aufruft, ist auch ein gutes Bei- 
spiel für experimentelles Programmieren. Ich kann mir nie 
den Offset im Stack merken (der vom Speichermodell und 
den vorher geretteten Registern abhängt), und meistens 
endete es mit Ungeheuern, die funktionierten, mich aber 
etwas entäuschten, wenn ich den Code anderen zeigte (Bild 
I). Mit dem neuen MASM 5.1 kann dasselbe Programm 
einfach so geschrieben werden: 


routine proc uses ax, varl:int 
mov ax, var] 


«weiteres Programm? 


| ret 
routine endp 





Dies ist verständlicher, obwohl der erzeugte Code nahe- 
zu identisch ist. 

Ein weiterer Grund zum Ärgern ist das Poppen der 
Register in einer anderen Reihenfolge als das Pushen. Dies 
führt zu Fehlern, die man relativ schnell findet. MASM löst 
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dies bei Verwendung der Anweisung uses. Der erzeugte 
Code ist nicht unbedingt effizienter, aber ein solches Pro- 
blem muß nicht länger durch die Verwendung des Debug- 
gers ausgetestet werden. 


MASM 5.1 


Die neuen Möglichkeiten von MASM 5.1 verbessern sowohl 
dıe Formalisierung der Makros, als auch die Makrofähig- 
keiten selbst. Bei einem Wechsel von 5.0 auf 5.1 brauchen 
Sie keine großen Änderungen in Ihren Quelldateien vor- 
zunehmen. Wenn Sie von Version 4.0 wechseln, werden Sie 
über die Möglichkeiten und die leichte Anwendung über- 
rascht sein, 


Makros 


Makros erlauben Ihnen die Definition neuer Operanden im 
MASM. Statt neue zu erzeugen, ordnen Sie einem Block 
von Befehlen einen symbolischen Namen zu, der auch mit 
Variablen als Argumenten versehen sein darf. Trifft der 
Assembler auf ein Makro, expandiert er es zu der vorher 
definierten Befehlssequenz. Makros können auch etwas 
intelligenter sein. Sie können unterschiedliche Befehls- 
sequenzen erzeugen, abhängig vom Argumenttyp oder der 
Anzahl der Argumente oder dem Speichermodell. Der 
Makroparser überprüft aber nur die Bedingungen zur 
Übersetzungszeit. Sie können nicht den Wert eines Regi- 
sters zur Laufzeit verwenden. Wenn Sie ihre eigenen 
Makros programmieren, werden Sie diese sinnvollerweise in 
einer Include-Datei halten. 

MASM 5.1 erlaubt die Verwendung von Textmakros, 
wıe etwa die Verwendung des Wertes rechts einer EQU- 
Anweisung als Makro. Bild 2 hätte in Version 5.0 einen 
Aufruf eines regulären Makros verlangt. Eine Möglichkeit 
wäre: 


msg_ print macro 
do print %errprint 


endn 

|do_print macro nsg list 
irp nsg, “nsg_list> 
push ax 
push de 
MOV ah,9 
mov dx, offset unsg 
int 21h 
pop dx 
pop ax 
endm 


In der Version 5.1 wird jedoch das mittlere Makro nicht 
mehr benötigt, und ein Makro wie das folgende ist erlaubt: 
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Iasg_ print macro 
irp msg, “msg_list> 
push ax 
push dx 


mov ah,9 

mov dx, offset nsg 
int 21h 

pop dx 





Das Prozentzeichen (%) am Anfang der IRP-Zeile ver- 
anlaßt die Textmakroauswertung. Es ergibt keinen ver- 
kürzten Code, aber die Anweisungen selbst sind einfacher 
zu verstehen. 

Eine weitere nette Möglichkeit ist die Verwendung des 
&-Zeichens für die Stringverknüpfung außerhalb eines 
Makros, ebenso wie Sie es früher innerhalb eines Makros 
taten: 


label equ <test_stuff> 
|#table entry &label db tester 





In MASM 5.0 war dies nicht erlaubt, und die Zeile mit 
tabel entry ohne & wurde vom Assembler als 
table _entry_label interpretiert und nicht ausgewertet. 

Sie können jetzt auch Teilstringsuche und Größe der 
Textmakroargumente ermitteln. Die Verwendung des SUB- 
STR-Operators veranlaßt im Bild 3 das Pushen der entspre- 
chenden Register. Die folgenden Zeilen pushen die Regi- 
ster ax und bx: 





Das zweite Argument ist die Startposition im String, die 
mit 1 beginnt, und das dritte Argument ist die Länge des 
Strings. 

CATSTR erlaubt das Zusammenführen einer Reihe von 
Strings in einen: 






big_ string CATSTR <stringl> ‚string2> 
ergibt für big_string "stringistring2". 
SIZESTR gibt die Stringlänge zurück und ergibt für fol- 
genden Ausdruck 14: 





Mit der INSTR-Anweisung erhalten Sie den Offset eines 
Substrings ınnerhalb eines Strings. Um zum Beispiel zu 
unterscheiden, ob ein Argument sowohl einen Offset als 
auch ein Segment enthält, können Sie nach dem Doppel- 
punkt an der dritten Stelle suchen: 


Makro-Assembler 





print msg nacro addr colon INSTR saddr? ,<:> 
if colon gt ® 

nsg_205 SUBSTR <addr?, 1,2 

|len SIZESTR <addr> 

lab SUBSTR <addr>,4,len - 3 


push ax 

push de 

push ds 

MOV dx, msg_seg 

mov ds, dx 

mov dx, offset lab 
ah, 9h 


int 


dx 

dx, offset addr 
ah, 9h 

21h 

dx 

AK 


pop 
endif 
endn 


start: 

print_msg 

print_msg 
int 


ret 
nsel db 
jen start 


Vordefinierte Makros 


MASM 5.1 enthält einige vom Assembler selbst vordefi- 
nierte Makros. @WordSize gibt die Größe der Segment- 
worte in Bytes zurück. Sie erhalten 4 bei Wortgrößen von 32 
Bit und 2 bei Wortgrößen von 16 Bit. Dies ist sehr hilfreich, 
wenn Sie die Direktive .386 aktiviert haben und ein 386- 
spezifisches Makro benötigen. 

@eCPU gibt ein eindeutiges Bitmuster zurück, das den 
verwendeten Prozessortyp, den Modus in dem sich der 286 
oder der 386 befindet (protected oder real) und die Art des 
installierten arithmetischen Coprozessors (falls überhaupt 
vorhanden) repräsentiert. Bedenken Sie aber, daß dies ein 
Makro ist, das zur Übersetzungszeit bewertet wird, und der 
Computer, auf dem das Programm später läuft, eine andere 
Konfiguration haben kann. 

Das Makro @Version gibt einen drei Zeichen langen 
Bezeichner zurück, der angibt, welche Version von MASM 
Sie verwenden. Die neueste Version meldet 510. Dies ist in 
früheren Versionen undefiniert, die Sie mit den folgenden 
Anweisungen testen können. 





IFNDEF &Version 


ELSE 
Erweiterungen vorhanden 


Zu guter Letzt sind keine IF-Ketten mehr als Ersatz für 
ein CASE-Statement notwendig! Sie können jetzt mit ELSE- 








IF-Anweisungen wie in Bild 4 arbeiten. 

Einige Erweiterungen für bedingtes Assemblieren 
erleichtern Ihnen ebenso die Arbeit. Stellen Sie sich einen 
Programmteil wie den folgenden vor: 


zb proc uses bx, es, Sr 
; Löschen des ersten Bytes, unabhängig vom Speichermodell 
if Bdatasize 
| les bx, pl 
;‚ im großen Speichermodell 
else 


moW bx, pl 
; im kleinen Speichernodell 


byte ptr [bx], 8 





Lokale Labels 


Ich hasse das Ausdenken von Variablennamen. Ich bin ein 
Befürworter des selbst dokumentierenden Programmierens. 
Variablen und Labelnamen müssen sinnbezogen sein, um 
Sinn beim Lesen des Programmes zu ergeben. Dies hilft 
während der Dokumentationsphase des Projektes. Aber das 
Ausdenken eindeutiger Namen ist schwierig, und der stän- 
dige Versuch, positionsunabhängige Programme zu erzeu- 
gen ıst mühsam. Mit dem MASM 5.1 können Sie jetzt den 
Operator @@ zur Definition von Vorwärts- oder Rückwärts- 
sprüngen benutzen. Diese Sprünge werden zur Überset- 
zungszeit bewertet (Bild 5). 


Die TYPE-Anweisung 


Abhängig vom Typ einer Variablen können Sie die Opera- 
tion auswählen, die auf dieses Argument oder diese Vari- 
able angewendet wird. Die TYPE-Anweisung wurde erwei- 
tert, um zu erkennen, ob ein Objekt programmabhängig 
(Code), datenabhängig, eine Konstante, ein Adressierungs- 
modus, ein Register (oder nicht) ist, definiert ist (oder 
nicht) und ob ein Symbol public oder lokal ist. 

Die kompletten Definitionen der Bitpositionen der 
TYPE-Anweisung sind im MASM-Handbuch aufgelistet. Als 
Beispiel, wie nützlich die TYPE-Anweisung sein kann, schen 
Sie hier ein Beispiel: 


print _me macro arg 
if ((.TYPE arg) AND REGISTER) 
push arg 
push de 
mov dx, arg 
call do print 
POP dx 
are 


| pop 
‚elseif 
push de 
mov dx, offset arg 


call 


do print 
pop dx 
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CodeView-Verbesserungen 


Wenn Sie zum Debuggen CodeView benutzen, dann nützt 
es, wenn der Objekttyp CodeView bekannt ist. Sie können 
dies veranlassen, wenn Sie die verbesserten und erweiterten 
PTR-Datendefinitionswörter (Bild 6) verwenden. 


Die Unterstützung von Hochsprachen 


Erstens und eigentlich bin ich ein C-Programmierer. 
Manchmal entdecke ich, daß ich C-Syntax verwende, wenn 
ich in Assembler programmiere, und zögere, mich in die 
Niederungen des Assemblers hinunterzubegeben. Ständig 
denke ich an die Mühen, die mich erwarten. Das richtige 
Setzen der Segmentregister, das Erinnern, wo und was das 
Datensegment ist, das Programmieren in gemischten Spei- 
chermodellen, das Lesen der Varıablen vom Stack, die Pro- 
bleme mit dem Unterstrich, es ist die Mühe nicht wert. 

Mit MASM 5.1 sind alle meine Ängste überflüssig. Es ist 
jetzt erheblich einfacher, Assembler- mit C-Programmen zu 
kombinieren. Obwohl mich eigentlich C interessiert, ist es 
doch wichtig, daß das Interface mit anderen Hochsprachen, 
auch mit BASIC sich erheblich vereinfacht hat. 

Wie schon früher erwähnt, gestattet MASM 5.1 die 
Verwendung des Schlüsselworts uses als Teil der PRO- 
Anweisung, um den Assembler zu informieren, welche 
Register Ihre Routine benötigt. Beim Programm 










ay proc Proc uses 4X dx 
| mov dx, offset cs:my_nsg 
mov ah, 9h 
int ah 







ret 
my_proc endp 










wird automatisch die richtige Kombination der Befehle 
push ax, pop ax und push dx, pop dx für Sie erzeugt. 
Die Grundsyntax ist das Trennen jedes Registers durch ein 
Leerzeichen, einen Tabulator oder ähnliches. 

Als ich meine Programme auf die Version 5.1 umstellte, 
verursachte dies einige Probleme. Ich verwendete eine 
Routine, die die Registerwerte rettete, und die Register AX 
und BX vertauschte. Wenn Sie irgendwelche Spielchen mit 
den Registerwerten treiben, die Sie vom Stack holen, müs- 
sen Sie die konventionelle Methode benützen. Oder Sie 
suchen dıe Ursache der Fehler und dokumentieren sie, oder 
ändern sie in einen vernünftigeren Zustand. 

Etwas überraschte mich und ist augenscheinlich nir- 
gends dokumentiert. Sie müssen die Anweisung .MODEL 
mit beiden Argumenten benützen, ansonsten wird die 
uses-Anweisung nicht richtig ausgeführt. Das erste Argu- 
ment der .MODEL-Anweisung ist das Speichermodell, das 
Sıe verwenden möchten, das zweite ist die Programmier- 
sprache, für die Sie das Modul verwenden möchten. Sie 
haben die Auswahl zwischen den Speichermodellen small, 
medium, compact, large oder huge. Die Angabe der 
Sprache wie in 
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generiert die Aufruf- und Rückgabesequenz für Sie, 
macht alle verwendeten Symbole public, und hängt an den 
Anfang den benötigten Unterstrich an, so daß der Linker 
nicht verwirrt wird. Sie müssen BASIC, C, Fortran oder 
Pascal angeben, da jede Sprache ihre eigenen Konventionen 
bezüglich Parametern und Namensgebung besitzt. 

Der Update von MASM kann beim Entwickeln von 
übertragbarem Code hilfreich sein. Sie brauchen nur die 
Sprachbezeichnung in der .MODEL-Anweisung von bei- 
spielsweise C nach BASIC zu ändern und MASM ändert 
automatisch die Aufruf- und Parameter-Konventionen ohne 
zusätzliche Arbeit. Das ist für Leute, die kommerzielle 
Bibliotheken entwickeln, sehr hilfreich. Ein Bibliothek für 
kompiliertes BASIC ist jetzt genauso einfach wie für C zu 
entwickeln. Sie brauchen nur den Bezeichner zu ändern und 
neu zu übersetzen. Unterstriche erscheinen und verschwin- 
den, wie von Geisterhand, genau so, wie es der entspre- 
chende Sprachübersetzer zum Linken benötigt. 


Stackadressierung 


Wie schon angesprochen können Sie die uses-Anweisung 
verwenden, um anzugeben, welche Register beim Proze- 
dureintritt gerettet und hinterher wieder vom Stack geholt 
werden sollen. Kombinieren Sie aber mit einer Hoch- 
sprache, wollen Sie sicherlich auch der Assemblerroutine 
Parameter übergeben. In den meisten Sprachen, und in 
ganz besonderem Maße bei C, erfolgt diese Parameter- 
übergabe auf dem Stack. Jedes Argument der Funktion 
wird auf dem Stack abgelegt, entweder von links nach 
rechts, oder von rechts nach links (abhängig, ob sie die 
Funktion als Pascal deklariert haben). Die Neuerungen 
von MASM erlauben Ihnen den leichten Zugriff auf diese 
Parameter, unabhängig vom verwendeten Speichermodell. 
Dies erspart Ihnen Stunden der Fehlersuche und des 
Neuschreibens des Quellcodes, wenn Sie öfters das Spei- 
chermodell wechseln. 

Nehmen wir einmal an, daß Sıe nicht den Pascal-Aufruf 
verwenden, der die Parameter von links nach rechts auf 
dem Stack ablegt. Haben Sie die C-Sprache mit der 
.MODEL-Anweisung aktiviert, dann können Sie eine Zeile 
wie in Bild 7 verwenden, die nicht nur angibt, daß das AX- 
Register beim Programmeintritt gerettet werden soll, son- 
dern Ihnen auch das direkte Ansprechen von drei Parame- 
tern auf dem Stack gestattet, wie bei: 





Dies kann unabhängig vom Speichermodell gemacht 
werden, und ohne den Funktionseintritts- und Endecode zu 
programmieren (Retten und Wiederherstellen des BP Regi- 
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sters), das automatisch für Sie erledigt wird. 

Sie können für Ihre Argumentlisten folgende Typen 
auswählen: word, dword, fword, qword, tbyte oder 
sogar den Namen einer Struktur (struc) 

Voreingestellt ist das Wort (für 8086/88/286/386) oder 
das Doppelwort, wenn Sie die . 386-Anweisung verwendet 
haben. 

Sie können den Typ ebenso mit den Zusätzen far, 
near oder ptr versehen, wie hier: 


my proc uses ax, argl:far ptr dword 


Es wird eine 4 Byte lange Variable auf dem Stack über- 
geben, die als far-Zeiger verwendet wird. Dies gestattet 
Ihnen die spätere Verwendung von: 













Der Zusatz ptr wird aber tatsächlich vom MASM für 
fast nichts benützt, außer, daß zusätzliche Informationen für 
die Verwendung von CodeView erzeugt werden. 

Die Routine in Bild 8 zum Beispiel ergibt die Debugger- 
anzeige in Bild 9 (zu der ich Kommentare angefügt habe). 
Derselbe Code, den Sie erzeugt haben. Augenscheinlich 
verwendete ich das Speichermodell small für dieses Bei- 
spiel. 


Lokale Variablen 


In einer Hochsprache wie C deklarieren Sie die lokalen 
Variablen am Funktionsanfang oder innerhalb eines Blocks, 
und der Speicherplatz wird Ihnen automatisch bereitgestellt. 
Am Funktionsende erfolgt die automatische Freigabe des 
Speichers. Sie benützen nur den Variablennamen, und der 
Compiler erledigt den Rest. MASM hatte schon immer 





erlaubt Ihnen die Verwendung des Namens tmp_buf, 
als wäre es eine richtige Variable. Solche Variablen haben 
allerdings globale Gültigkeit, und ich verwendete stets 
Namen wie tmp_buf_ serial routine um sie von ande- 
ren tmp_bufs zu unterscheiden. Es wurde aber kein Platz 
auf dem Stack gespart, und eine unachtsame Push-/Pop- 
Sequenz konnte den Stack in einer sonderbaren Weise ver- 
ändern. Mit MASM 5.1 können Sie jetzt Variablen mit 
einem nur lokalen Gültigkeitsbereich allokieren. Die 
Namen existieren nur innerhalb der Prozedur, in der sie 
definiert sind. Sehen Sie zum Beispiel Bild 10, wo MASM 
veranlaßt wird, hinter den Kulissen, fast geisterhaft, ein 
Textmakro zu expandieren. Hier ist ein einfaches Beispiel: 


HEADER SIZE equ 


DATA SIE equ 
CRC_SIZE equ 





Der Quellcode, der von MASM 5.1 erzeugt wird, ist in 
Bild 11 zu sehen (der Cast von tmp_buf wird benötigt, weil 
tmp_buf als Bytearray definiert ist). Der Dump, mit den 
Aufrufen der anderen Routinen, der zu diesem Zweck 
angefertigt wurde, ist im Bild 12 zu sehen. 


Übersetzungshilfen 


Die Übersetzungshilfen für Ihren nicht mit Makros ver- 
sehenen MASM-Code sind sehr einfach: 

Zuerst müssen Sie Ihre Push/Pop Befehlszeilen in die 
entsprechenden uses-Statements ändern. MASM ist in 
einer Beziehung nicht so zuvorkommend. Jeder Ret-Befehl 
erzeugt die erforderliche Pop-Befehlssequenz, deshalb 
sollten Sie die Routinen so ändern, daß sie nur ein Ret- 
Statement enthalten, mit Sprunganweisungen von anderen 
Stellen direkt auf dieses Statement. Dies ist auf jeden Fall 
auch gute Programmierpraxis. 

Als nächstes sollten Sie alle Argumentübergaben in die 
neue proc-Anweisung ändern. Denken Sie auch daran, die 
Anweisungen PUSH BP/MOV BP,SP/../POP BP zu entfer- 
nen. MASM erzeugt diese Befehle automatisch für Sie. 

Schauen Sie sich die Stellen an, an denen Sie lokalen 
Speicher vom Stack allokiert haben (versuchen Sie eine glo- 
bale Suche nach SUB SP, und ändern dies in die neue 
lokale Aufrufkonvention. 

Nun die schwierigste Aufgabe. Das Konvertieren aller 
Programmteile in die neuen Textmakros, um die Vorteile 
der Neuerungen zu nutzen. Sie müssen entscheiden, ob es 
sich auch lohnt, in die neue Form umzuändern. 

Denken Sie daran, die .MODEL-Anweisung einzuset- 
zen, sonst verhält sich MASM 5.1 wıe seine Vorgänger, und 
Sie erhalten eine Menge Fehlermeldungen. 

MASM 5.1 ist nur ein Upgrade. Ein evolutionärer, kein 
revolutionärer. Ein Reihe weiterer Neuerungen enthält das 
Paket noch, nicht nur den Assembler. Dazu gehören der 
neue CodeView, die Fähigkeit, leicht mit den dynamischen 
OS/2-Bibliotheken zu binden, die Updates zu BIND, IM- 
PLIB, MAKE, ILINK und das Dienstprogramm EXEHDR 
dazu. Der Microsoft Editor gehört jetzt ebenso zu dem 
Paket. 

‚Ich konnte die Anzahl meiner Quellcodezeilen um unge- 
fähr 30% reduzieren, und ich zögere weniger, wenn ich 
MASM-Routinen in einem C-Programm benutzen soll. 
Auch brauche ich viel weniger Zeit, meine Assembler- 
module zu debuggen. Jetzt kann ich die gewonnene Zeit 
zum Dokumentieren meiner Funktionen benutzen, sobald 
ich eine Routine ausgetestet habe. 

Ross M. Greenberg 
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routine Pos <Nane} 
push bp 
mov bp, Sp 
push ax 


mov ax, ss:[bp + SPEICHER MODEL + OFS_VAR1] 
«Anderer Code? 


\roeutine endp 


Bild 1: Beispiel der alten Methode, die das Erzeugen eines 
User Stacks und das Pushen und Poppen der Register voraus- 
setzte. 


reg_push macro start 

reg substr <axbxesdxsidib>, (start - I) #2 +1, 2 
push reg 

endn 


ELSEIF <test) 
ELSEIF <test) 
[ELSEIF! 
ELSEIF2 
|ELSEIFB <arg> 
ELSEIFNB <arg> 


wenn <test> wahr ist 

wenn <test> falsch 

wenn pass] 

wenn pass2 

wenn Leerzeichen 

wenn kein Leerzeichen 

wenn definiert 

wenn nicht definiert 

wenn unterschiedlich 

wern unterschiedlich, unabhängig 
von Groß-/Kleinschreibung 
wenn identisch 

wenn identisch, unabhängig von 
Groß-/Kleinschreibung 


ELSEIFDEF <arg> 
ELSEIFNDEF <arg> 
ELSEIFDIF <arg!>, <arg2> 
ELSEIFDIFI <arg1>, <arg2> 


'ELSEIFIDN <arg1>, <arg2> 
ELSEIFIDNI <arg!>, <arg2> 


| I Tame" Daaeer Damen: ae Das Da: st Be | 


Bild 4: Neue ELSEIF-Optionen. 
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Die „C” Techniken bringen neue Perspektiven für Kon- 
strukteure, Ingenieure, Architekten und Designer. CAD, 
CAM, CAP oder CAE gehörenschonzum Sprachgebrauch 
invielen Branchen. Denn immer mehrwerdendiese Tech- 
niken auch auf Computern einsetzbar, die jedermann nut- 
zen kann: Auf Personal Computern und Workstations. 

Konstruieren und Entwickeln per Computer, Zeichnen 
und Planen am Bildschirm sind die zukunftsweisenden 
Arbeitstechniken. Und es sind genau die Themen des 
neuen AUTOCAD Magazins: Die „C’-Techniken mit allen 
ihren Perspektiven. 

In Theorie und Praxis. In Anwender- und Erfahrungs- 
berichten. Mit Hard- und Software-UÜbersichten. Mit 
Beschreibungen und Tests. Mit Einsatzbeispielen und Ein- 
satzvoraussetzungen. 

Mit allen Themen eben, die zu diesem Thema gehören. 
Im AUTOCAD Magazin wird vor Ihnen das ganze Spek- 
trum dieser Möglichkeiten aufgeblättert. Denn es ist das 
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sonal Computern und Workstations beschäftigt. Und das 
deshalb ganz speziell und detailliert auf diese Thematik 
eingehen kann. 

Wer von Berufs wegen dieses Thema im Auge haben 
muß, istmitdem AUTOCAD-Abonnementautomatischim 
Bilde. Denn es ist ein Abonnement auf wichtige und 
aktuelle Informationen. 
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DO) das AUTOCAD-Magazin im Abonnement (vorerst 
4 Ausgaben pro Jahr! zum Abopreis von DM 46,- 
(4x 9,- zzgl. Versandkosten). 
Ich kann das Abonnement B Wochen vor Ende 
des Bezugszeitraumes kündigen. 


DU ein Einzelheft zum Preis von DM 14,50 
(DM 12,— + DM 2,50 Versandkosten) 


Ü[) gegen Vorauszahlung auf unser Post-Girokonto 
München, Kto.-Nr. 99069-804, BLZ 700 10080 
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H.H, Gerhardt: DOS 3.3 für PCs und Personal System/2 
1988, 334 Seiten 

Eine leichtverständliche Einführung mit Beispielen, 
Ubungen und alphabetischer Befehlsübersicht. Für 
Anfänger und Fortgeschrittene. Mit umfangreichem für PCs und 
Anhang: Begrifiserklärung, Zeichencode-Tabellen, Kurs- Personal A] 
darstellung zum Thema »Netzwerk«, Fehlerübersicht, he ‚>y2 ira 
Übersicht zu den »DOS Function Calls« und »DOS Inter- En 

rupt Calls, 

Bestell-Nr. 90547 ISBN 3-89090-547-1 
DM69,-'sFr 6350/05 538,20 
























Peter Norton: Peter Nortan’s Assemblerbuch 
1988, 352 Seiten, inkl. Diskette 

Wenn Sie dieses Buch gelesen haben, wissen Sie, wie Sie 
vollständige Programme in Assemblersprache schreiben 
können: Texteditoren, Utilities und vieles mehr. Dabei lernen 
Sie eine Reihe von Techniken kennen, die von professionel- 
lan Programmierern verwendet werden! 

Bestell-Nr. 90624, ISBN 3-890%0-624-9 

DM 79,-'sFr 72.2005 616,20 














H.H. Gerhard: PC-DOS/MS-DOS 3.2 
1987, 299 Seiten, inkl, Diskette 

Eine Einführung in die wichtigsten Grundlagen zur 

Bedienung Ihres PCs mit DOS sowie ein hilfreiches 
Nachschlagewerk für jeden DOS-Anwender. Mit aus- | 
2 führlichen Beiehlsbeschreibungen, alohabetischem 
| Nachschlageteil und vielen Beispielen im PC-DOS- 

| und MS-DOS-Format auf Diskette. 

Bestell-Nr. 90519 ISBN 3-89090-519-65 

| DM59,-'SFr 54,30165 460,20 
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H.Drees: Unix 
1988, ca.600 Seiten 
Ein umfassendes Kompendium für Anwender 
und Systemspezialisten. Es beschreibt kein 
spezielles Unix, sondern Unix schlechthin 
und stützt sich dabei auf den Leistungs- 
standard, der durch Unix V repräsentiert 
| wird, Mit vielen Beispielen und Anregungen, 
Bestell-Nr. 90494 ISBN 3-89090-494-7 
| DM 89,-/sFr 81.9065 694,20 a en 45 EDITION 
a ans fürs Zoft ” pen | 
ı  _ 5.M.Sonner/M. Theis: MS-0S/2 
zart fr ic Dr leur für Software-Entwickler 
1988, 474 Seiten 
EDITION Dieses Buch bietet eine Einfüh- 
rung und einen Überblick über die 
theoretische Grundlagen von 
05/2. Es wendet sich an Software- 
Entwickler und ein interessiertes 
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Dr. Norbert Meder: MS-0&2 
1988 304 Seiten 
Einführung und Überblick 
über die neuen Program- 
miermöglichkeiten von 
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| U,Schmidt: Das MS-Windows-Kompendium | 









1988, ca.350 Seiten, inkl. zwei Disketten Fachpublikum. M>-OSY2. Den Schwerpunkt 
Tips, Tricks und Training, eine ausführliche Bastell-Nr 906.33 bildet der neue Befahlsvorrat 
u P rogrammdokumentation und Hilfen bei der ISBN 3-89090-638-9 von Mo-OS/2. Die einzelnen 


Befehle werden anhand von 
Beispielen leichtverständlich 
erläutert. Auch die Batch- 
Programmierung wird 
behandelt. 

Bestell-Nr 90512 

| ISBN 389090-512-9 

DM 79.-"sFr 72.2065 616,20 
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finden Sie in diesem umfangruichen Kom- 

a pendium. Für Windows 2,0 und 386. Auf 

“ den zwei Disketten finden Sie ein ausführ- 
liches Hilfsprogramm mit Installations- 

L programm für die Festplatte, Utilities und 

m zahlreiche Beispiele. 

Bestell-Nr. 90558 ISEN 3-89090-558-7 

DM 69,-5Fr 6350055 538,20 
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